From a50f11c4530b94a69455ec741c4ff25f7ad12d71 Mon Sep 17 00:00:00 2001 From: CabLate Date: Sat, 14 Mar 2026 14:41:28 +0800 Subject: [PATCH 1/4] docs: rewrite README header with value proposition and comparison table - Add one-liner value proposition - Add 3-bullet feature highlights (8 tools, 3 modes, Agent Skill) - Add vs Google Grounding Lite comparison table - Consolidate Quick Start to show all 3 modes - Remove verbose compatibility section and Important Notice box Co-Authored-By: Claude Opus 4.6 --- README.md | 45 +++++++++++++++++++++++---------------------- 1 file changed, 23 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index d4c258b..234a520 100644 --- a/README.md +++ b/README.md @@ -6,42 +6,43 @@ # MCP Google Map Server ---- +Give your AI agent the ability to understand the physical world — geocode, route, search, and reason about locations. -> **Important Notice** -> -> Google officially announced MCP support for Google Maps on December 10, 2025, introducing **[Maps Grounding Lite](https://cloud.google.com/blog/products/ai-machine-learning/announcing-official-mcp-support-for-google-services)** - a fully-managed MCP server for geospatial data and routing. -> -> This community project remains actively maintained as an alternative with different features and deployment options. +- **8 tools** — geocode, reverse-geocode, search-nearby, search-places, place-details, directions, distance-matrix, elevation +- **3 modes** — stdio, StreamableHTTP, standalone exec CLI +- **Agent Skill** — built-in skill definition teaches AI how to chain geo tools ([`skills/google-maps/`](./skills/google-maps/)) ---- +### vs Google Grounding Lite -Google Maps tools for AI agents — use as an **MCP server** or as a standalone **Agent Skill** via CLI. +| | This project | [Grounding Lite](https://cloud.google.com/blog/products/ai-machine-learning/announcing-official-mcp-support-for-google-services) | +|---|---|---| +| Tools | **8** | 3 | +| Geocoding | Yes | No | +| Step-by-step directions | Yes | No | +| Elevation | Yes | No | +| Distance matrix | Yes | No | +| Place details | Yes | No | +| Open source | MIT | No | +| Self-hosted | Yes | Google-managed only | +| Agent Skill | Yes | No | + +### Quick Start ```bash -# Agent Skill — no server needed +# stdio (Claude Desktop, Cursor, etc.) +npx @cablate/mcp-google-map --stdio + +# exec CLI — no server needed npx @cablate/mcp-google-map exec geocode '{"address":"Tokyo Tower"}' -npx @cablate/mcp-google-map exec search-places '{"query":"ramen in Tokyo"}' -# MCP Server +# HTTP server npx @cablate/mcp-google-map --port 3000 --apikey "YOUR_API_KEY" ``` -All 8 tools available in both modes. See [`skills/google-maps/`](./skills/google-maps/) for the full agent skill definition. - ## Special Thanks -This project has received contributions from the community. Special thanks to [@junyinnnn](https://github.com/junyinnnn) for helping add support for `streamablehttp`. -## Verified Compatibility - -This MCP server has been tested and verified with: - -- Claude Desktop -- Dive Desktop -- MCP protocol implementations - ## Available Tools | Tool | Description | From dc80ae5847ff3e5a85473b7ed212da32039caa9e Mon Sep 17 00:00:00 2001 From: CabLate Date: Sat, 14 Mar 2026 14:43:34 +0800 Subject: [PATCH 2/4] docs: add install badges and npm/license shields - One-click install badges for VS Code and VS Code Insiders - npm version, license, and monthly downloads shields Co-Authored-By: Claude Opus 4.6 --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 234a520..0c4d64a 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,7 @@ +[![npm version](https://img.shields.io/npm/v/@cablate/mcp-google-map)](https://www.npmjs.com/package/@cablate/mcp-google-map) [![license](https://img.shields.io/github/license/cablate/mcp-google-map)](./LICENSE) [![npm downloads](https://img.shields.io/npm/dm/@cablate/mcp-google-map)](https://www.npmjs.com/package/@cablate/mcp-google-map) + +[Install in VS Code](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522google-maps%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540cablate%252Fmcp-google-map%2540latest%2522%252C%2522--stdio%2522%255D%252C%2522env%2522%253A%257B%2522GOOGLE_MAPS_API_KEY%2522%253A%2522YOUR_API_KEY%2522%257D%257D) [Install in VS Code Insiders](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522google-maps%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540cablate%252Fmcp-google-map%2540latest%2522%252C%2522--stdio%2522%255D%252C%2522env%2522%253A%257B%2522GOOGLE_MAPS_API_KEY%2522%253A%2522YOUR_API_KEY%2522%257D%257D) + [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cablate-mcp-google-map-badge.png)](https://mseep.ai/app/cablate-mcp-google-map) From 5cc59af5bc02bc3e24449301cbcc56f9723e1704 Mon Sep 17 00:00:00 2001 From: CabLate Date: Sat, 14 Mar 2026 14:50:12 +0800 Subject: [PATCH 3/4] docs: remove MseeP badge Co-Authored-By: Claude Opus 4.6 --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 0c4d64a..c3992f3 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,6 @@ [Install in VS Code](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522google-maps%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540cablate%252Fmcp-google-map%2540latest%2522%252C%2522--stdio%2522%255D%252C%2522env%2522%253A%257B%2522GOOGLE_MAPS_API_KEY%2522%253A%2522YOUR_API_KEY%2522%257D%257D) [Install in VS Code Insiders](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522google-maps%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540cablate%252Fmcp-google-map%2540latest%2522%252C%2522--stdio%2522%255D%252C%2522env%2522%253A%257B%2522GOOGLE_MAPS_API_KEY%2522%253A%2522YOUR_API_KEY%2522%257D%257D) -[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cablate-mcp-google-map-badge.png)](https://mseep.ai/app/cablate-mcp-google-map) - Google Map Server MCP server From 187f0070774c6fbfb04b023bf38713e60c9e09cc Mon Sep 17 00:00:00 2001 From: CabLate Date: Sat, 14 Mar 2026 14:51:54 +0800 Subject: [PATCH 4/4] docs: move Glama badge to bottom near Star History Co-Authored-By: Claude Opus 4.6 --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c3992f3..4d3e3a7 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,6 @@ [Install in VS Code](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522google-maps%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540cablate%252Fmcp-google-map%2540latest%2522%252C%2522--stdio%2522%255D%252C%2522env%2522%253A%257B%2522GOOGLE_MAPS_API_KEY%2522%253A%2522YOUR_API_KEY%2522%257D%257D) [Install in VS Code Insiders](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522google-maps%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540cablate%252Fmcp-google-map%2540latest%2522%252C%2522--stdio%2522%255D%252C%2522env%2522%253A%257B%2522GOOGLE_MAPS_API_KEY%2522%253A%2522YOUR_API_KEY%2522%257D%257D) - - Google Map Server MCP server - - # MCP Google Map Server Give your AI agent the ability to understand the physical world — geocode, route, search, and reason about locations. @@ -262,4 +258,8 @@ Community participation and contributions are welcome! ## Star History + + Google Map Server MCP server + + [![Star History Chart](https://api.star-history.com/svg?repos=cablate/mcp-google-map&type=Date)](https://www.star-history.com/#cablate/mcp-google-map&Date)