用途:该项目知识用于开发和维护 @cablate/mcp-google-map 这个 MCP 服务器。它提供架构说明、Google Maps API 使用指南、GIS 领域知识以及设计决策记录,帮助开发者或代理在扩展、调试该服务器时掌握完整背景。若要了解如何使用这些工具(面向代理的使用技能),需参阅 skills/google-maps/SKILL.md。
主要能力:该服务器以 TypeScript、Node.js、Express、MCP SDK、Zod 为技术栈,提供 18 个工具(14 个原子工具 + 4 个组合工具),支持 stdio、Streamable HTTP、独立 exec CLI 三种传输方式。所涉 API 包括 Places API (New)、Directions、Geocoding、Elevation、Timezone、Weather、Air Quality、Static Maps、Search Along Route。
参考文件:references/architecture.md 介绍系统架构、三层设计、传输模式、工具注册流程、9 文件清单与代码地图;references/google-maps-api-guide.md 列出所用 API 端点、定价、覆盖限制、速率限制、常见陷阱及 Places New 与 Legacy 对比;references/geo-domain-knowledge.md 涵盖坐标、距离、地理编码、地点类型、空间搜索、地图投影及日本特定知识;references/decisions.md 收录 10 条架构决策记录(ADR)。
新增工具流程:创建 src/tools/maps/<toolName>.ts(含 NAME、DESCRIPTION、SCHEMA、ACTION);在 src/config.ts 注册;在 src/cli.ts 添加 exec case;在 tests/smoke.test.ts 添加 expectedTools 与 API 调用测试;更新 README.md(数量、表格、exec 列表、项目结构);更新 skills/google-maps/SKILL.md 的 Tool Map;更新 skills/google-maps/references/tools-api.md 的参数与链式调用;检查 server.json 与 package.json 描述。
何时更新:架构变更更新 architecture.md;集成新 API 更新 google-maps-api-guide.md;产生新设计决策向 decisions.md 添加 ADR;新增相关 GIS 概念更新 geo-domain-knowledge.md。
限制:资料未提供具体安装命令、完整代码示例、定价数值与工具参数细节,需查阅相应参考文件。