iceener/maps-streamable-mcp-server
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Google지도와 상호 작용하는 MCP 서버 (Places API 및 Routes API). TypeScript, Node 및 Hono.dev에 서면
개요
이 서버는 Google지도의 원격 모델 Context Protocol (MCP) 서버입니다. 그것은 장소를 찾을, 장소 세부 사항, 및 계획 경로. Google Maps Platform Places API(New) 및 Routes API를 사용합니다. 서버가 켜져 . MCP 서버 템플릿, 버전 2.1 및 공식 MCP TypeScript SDK 2.3.0에 내장되어 있습니다. 그것은 프로토콜 버전 2026-07-28을 사용합니다. 또한 2025 프로토콜 버전을 사용하는 클라이언트를 허용합니다. 서버는 사용자의 위치를 알고있는 에이전트, 예를 들어 시계 또는 전화. 클라이언트는 현재 위치를 주고, 모형은 할 수 있습니다: - 사용자 근처의 장소를 찾기, 유형 또는 이름으로. - 영업 시간, 등급, 리뷰, 연락처 데이터 및 장소의 사진을 읽으십시오. - 산책, 운전, 사이클링, 또는 이동 방향을 얻으십시오. - 여러 목적지에 거리를 비교합니다. 각 도구는 모델과 구조화된 데이터에 대한 텍스트를 제공합니다. 도구 설명은 모든 입력 및 출력을 제공합니다. 모든 도구는 데이터 만 읽습니다.
개요(AI 번역)
이 서버는 Google지도의 원격 모델 Context Protocol (MCP) 서버입니다. 그것은 장소를 찾을, 장소 세부 사항, 및 계획 경로. Google Maps Platform Places API(New) 및 Routes API를 사용합니다.
서버는 Cloudflare Workers 및 ** Bun**에서 실행됩니다. MCP 서버 템플릿, 버전 2.1 및 공식 MCP TypeScript SDK 2.3.0에 내장되어 있습니다. 그것은 프로토콜 버전 2026-07-28을 사용합니다. 또한 2025 프로토콜 버전을 사용하는 클라이언트를 허용합니다.
서버는 사용자의 위치를 알고있는 에이전트, 예를 들어 시계 또는 전화. 클라이언트는 현재 위치를 주고, 모형은 할 수 있습니다:
- 사용자 근처의 장소를 찾기, 유형 또는 이름으로.
- 영업 시간, 등급, 리뷰, 연락처 데이터 및 장소의 사진을 읽으십시오.
- 산책, 운전, 사이클링, 또는 이동 방향을 얻으십시오.
- 여러 목적지에 거리를 비교합니다.
도구
| 도구 | 기능 |
|—|||
| search_places | 위치의 찾기 query, 텍스트 검색 (“sushi”, “Starbucks”). types로, 그 유형의 장소 (“cafe”, “pharmacy”). 하지 않고, 반경에 모든 장소를 찾을 수 있습니다. ·
| get_place | [T5]의 장소의 상세정보를 게재합니다.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Google Maps MCP Server
This server is a remote Model Context Protocol (MCP) server for Google Maps. It finds places, gives place details, and plans routes. It uses the Google Maps Platform Places API (New) and Routes API.
The server runs on Cloudflare Workers and on Bun. It is built on the MCP server template, version 2.1, and the official MCP TypeScript SDK 2.3.0. It uses protocol version 2026-07-28. It also accepts clients that use the 2025 protocol versions.
The server is for agents that know the location of the user, for example on a watch or a phone. The client gives the current position, and the model can:
- Find places near the user, by type or by name.
- Read the opening hours, ratings, reviews, contact data, and photos of a place.
- Get walking, driving, cycling, or transit directions.
- Compare the distance to several destinations.
Tools
| Tool | Function |
|---|---|
search_places |
Finds places near a location. With query, it does a text search (“sushi”, “Starbucks”). With types, it finds places of those types (“cafe”, “pharmacy”). With neither, it finds all places in the radius. |
get_place |
Gives the details of a place from a place_id. Select the data with fields: basic, contact, hours, reviews, photos. |
get_route |
With one destination, gives a route, and turn-by-turn steps if you ask for them. With two or more destinations (25 maximum), compares the time and distance to each, and names the closest. |
Each tool gives text for the model and structured data. The tool descriptions give all inputs and outputs. All tools only read data.
Examples of requests:
- “Coffee near me”:
search_placeswithtypes: ["cafe"]andopen_now: true. - “Is the pharmacy on Main Street open?”:
search_places, thenget_placewithfields: ["hours"]. - “Which is closer, A or B?”:
get_routewith both places as destinations.
Photo results contain public image URLs that Google makes for each request. They never contain the API key.
Connect a client
The server URL is the deployed Worker’s MCP_PUBLIC_URL, for example https://google-maps..workers.dev/mcp. Use the Streamable HTTP transport, and send the shared token in the Authorization header.
| Client | Procedure |
|---|---|
| Alice | Add an MCP server. Set the URL, the type streamable-http, and the header Authorization: Bearer . |
| Claude Code | Run claude mcp add --transport http google-maps --header "Authorization: Bearer ". |
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →