Google Maps

谷歌地图MCP服务器

一种模型上下文协议（MCP）服务器，将谷歌地图的路线和交通功能与克劳德人工智能集成在一起，用于高级路线规划、交通分析和成本估算。

先决条件

• Node.js （建议使用LTS版本18+）-从下载
• 谷歌地图API密钥 已启用所需服务
• 克劳德桌面 MCP集成应用

安装说明

1.克隆和安装

git clone [your-repo-url]
cd google-maps-mcp-server
npm install

2.获取谷歌地图API密钥

1. 首选 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用以下API：

- API指南 （路由需要） - 距离矩阵API （交通数据需要） - 地理编码API （地址查找所需） - 地点API （可选，用于增强地址搜索）

1. 创建凭据→ API密钥
2. 将API密钥限制为以上已启用的服务

3.配置API密钥

编辑 config/config.json 并替换 GOOGLE_API_KEY 使用您的实际API密钥：

{
  "googleMaps": {
    "apiKey": "your-actual-api-key-here"
  }
}

4.测试服务器

# Test configuration
npm test

# Start in development mode
npm run dev

5.配置克劳德桌面

将此添加到您的Claude Desktop MCP设置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-maps": {
      "command": "node",
      "args": ["/absolute/path/to/google-maps-mcp-server/src/index.js"],
      "cwd": "/absolute/path/to/google-maps-mcp-server"
    }
  }
}

6.开始使用

重新启动Claude Desktop，您现在可以提出以下问题：

• “找到从纽约到波士顿的最快路线”
• “比较有和没有通行费的机场路线”
• “我现在上下班的交通怎么样？”

可用工具

• 计算路由：考虑交通因素和航路点，获得最佳路线
• 比较路线：比较具有不同选项的多个路线备选方案
• get_live_traft：获取实时交通信息和旅行延误
• 估算成本：计算行程成本，包括燃料和通行费估算

故障排除

常见问题

1.“请设置您的谷歌地图API密钥”错误

• 检查一下 config/config.json 有实际的API密钥，而不是 GOOGLE_API_KEY
• 确保JSON格式有效（没有尾随逗号）

2.“谷歌地图API错误”消息

• 验证您的API密钥是否有效并启用了所需的API
• 在Google云控制台中检查API配额和账单
• 确保您的API密钥不限于错误的域/IP

3.“未找到路线”错误

• 检查地址是否有效且存在
• 尝试使用坐标而不是地址（lat、lng格式）
• 核实这些地点是否可以开车到达

4.服务器无法启动

# Check Node.js version
node --version  # Should be 18+

# Clear dependencies and reinstall
rm -rf node_modules package-lock.json
npm install

# Check for configuration errors
npm test

5.克劳德桌面找不到服务器

• 在Claude Desktop配置中使用绝对路径
• 配置更改后重新启动Claude Desktop
• 检查MCP配置文件路径是否适合您的操作系统

调试模式

运行调试日志：

DEBUG=* npm start

测试单个工具

# Test route calculation
echo '{"origin":"New York, NY","destination":"Boston, MA"}' | node src/index.js

# Check API connectivity
curl "https://maps.googleapis.com/maps/api/directions/json?origin=NYC&destination=Boston&key=YOUR_API_KEY"

配置选项

编辑 config/config.json 自定义：

{
  "googleMaps": {
    "apiKey": "your-api-key"
  },
  "server": {
    "port": 3001,
    "host": "localhost"
  },
  "routing": {
    "defaultTrafficModel": "best_guess",
    "maxWaypoints": 25,
    "maxAlternatives": 3,
    "units": "metric"
  },
  "costs": {
    "fuelPricePerLiter": 1.50,
    "vehicleFuelEfficiency": 8.0,
    "tollEstimatePerKm": 0.05
  }
}

许可证

MIT许可证-随意修改和分发。