cablate/mcp-google-map
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
강력한 모델 컨텍스트 프로토콜(MCP) 서버로, LLM 처리 기능과 함께 포괄적인 Google 지도 API 통합을 제공합니다.
개요
AI 에이전트가 물리적 세계를 이해할 수 있도록 — 지오코딩, 경로, 검색, 위치 추론 등을 가능하게 하세요. - — 14 atomic + 4 composite (explore-area, plan-route, compare-places, local-rank-tracker) - — stdio, StreamableHTTP, 독립형 exec CLI - — 내장 스킬 정의가 AI에게 지오 도구를 연속으로 연결하는 방법을 가르칩니다 (스킬/구글 맵/) streamablehttp 지원을 추가하는 데 도움을 준 @junyinnnn에게 특별히 감사드립니다. 모든 도구는 readOnlyHint: true와 destructiveHint: false로 주석이 달려 있습니다 — MCP 클라이언트는 사용자 확인 없이도 자동 승인할 수 있습니다. : 장소 관련 및 라우팅 도구를 사용하기 전에 Google Cloud Console에서 활성화하세요. Claude Desktop, 커서, VS 코드 및 stdio를 지원하는 모든 MCP 클라이언트에서 작동합니다: — 도구 일부만 필요하다면, GOOGLE_MAPS_ENABLED_TOOLS 등록 도구를 제한하도록 설정하세요: 18가지 도구 모두에 대해 생략하거나 *로 설정하세요(기본값).
개요(AI 번역)
모든 AI 앱의 장소 검색, 라우팅, 위치 워크플로우를 재구축하는 것을 멈추세요.
@cablate/mcp-google-map는 Google Maps Platform을 18개의 읽기 전용 에이전트 도구와 세 가지 집중 기술로 전환합니다. 에이전트는 실제 장소를 찾고, 경로를 확인하며, 옵션을 비교하고, 실용적인 일정을 만들거나, 지역 검색 가시성을 감사할 수 있습니다—이는 MCP 또는 독립형 CLI를 통해 이루어집니다.
통합 모델을 선택하면 됩니다: MCP 설정 없이 Skills를 원할 때는 Codex 또는 Claude Code 플러그인, 데스크톱 MCP 클라이언트에는 Stdio, 공유 및 원격 배포에는 Streamable HTTP를 선택하세요.
영어 · 繁體中文
왜 그걸 쓰는 거야?
에이전트에게 원시 지도 API를 제공하는 것은 시작에 불과합니다. 유용한 답변은 종종 여러 의존 호출을 필요로 합니다: 장소 해석, 신원 보존, 주변 탐색, 개방 세부 정보 확인, 이동 시간 계산, 그리고 실제로 검증된 내용을 설명하기. 이 프로젝트는 이를 하나의 일관된 인터페이스로 묶어 사용합니다.
- 조회에서 결과로 이동하기. 원자 도구는 지오코딩, 장소 세부사항, 길 안내, 날씨, 대기질, 지도를 처리합니다. 복합 도구는 지역을 탐색하고, 후보를 비교하며, 정차를 최적화하고, 지역 순위를 측정합니다.
- **MCP 유무와 관계없이 동일한 기능을 사용하세요.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Google Maps for AI agents
Stop rebuilding place search, routing, and location workflows for every AI app.
@cablate/mcp-google-map turns Google Maps Platform into 18 read-only agent tools and three focused Skills. An agent can find real places, verify routes, compare options, build practical itineraries, or audit local search visibility—through MCP or a standalone CLI.
You choose the integration model: Codex or Claude Code Plugin when you want Skills without MCP setup, stdio for desktop MCP clients, or Streamable HTTP for shared and remote deployments.
English · 繁體中文
Why use it?
Giving an agent a raw Maps API is only the beginning. Useful answers often require several dependent calls: resolve a place, preserve its identity, search around it, check opening details, calculate travel time, and explain what was actually verified. This project packages that work into one consistent interface.
- Move from lookup to outcome. Atomic tools handle geocoding, place details, directions, weather, air quality, and maps. Composite tools explore areas, compare candidates, optimize stops, and measure local rankings.
- Use the same capabilities with or without MCP. The standalone
execCLI works with Agent Skills and automation; the MCP server exposes the same 18 tools over stdio or HTTP. - Give agents workflow guidance, not just function names. Three Skills cover general map research, evidence-backed travel planning, and local SEO. Codex loads their full instructions only when a request matches.
- Keep deployment and credentials under your control. Run locally or self-host. API keys remain in your environment or request headers, with per-session isolation for HTTP deployments.
- Start narrow and grow later. Register only the tools you need with
GOOGLE_MAPS_ENABLED_TOOLS, or use the full catalog.
What can an agent do?
| Outcome | How the project helps |
|---|
설치
npx -y @cablate/mcp-google-map --stdio설정
{
"mcpServers": {
"google-maps": {
"command": "npx",
"args": ["-y", "@cablate/mcp-google-map", "--stdio"],
"env": { "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY" }
}
}
}