Google Maps MCP Cloudrun

用于云运行的Google Maps MCP服务器

一种谷歌地图模型上下文协议（MCP）服务器，专为在谷歌云运行上部署而设计，可供公众访问。该服务器通过一个安全的、有费率限制的API为Claude Desktop客户端提供谷歌地图功能。

特性

• 路线计算：具有实时交通数据的最佳驾驶路线
• 路线比较：比较具有不同选项的多个路由备选方案
• 路况：当前交通状况和旅行时间分析
• 成本估算：行程成本计算，包括燃料和通行费估算
• 公共访问：无需身份验证即可轻松共享
• 速率限制：每个IP地址每小时50个请求
• 云运行优化：专为GCP上的无服务器部署而设计

先决条件

• 启用计费的Google Cloud Platform帐户
• 谷歌云CLI(gcloud)已安装并配置
• Node.js 18+用于本地开发
• 启用了所需API的Google Maps API密钥

所需的谷歌地图API

在部署之前，请在GCP项目中启用这些API：

1. API指南 -用于路线计算
2. 地理编码API -用于地址解析
3. 映射JavaScript API -用于折线编码（可选）

通过以下方式启用API 谷歌云控制台 或CLI：

gcloud services enable directions-backend.googleapis.com
gcloud services enable geocoding-backend.googleapis.com
gcloud services enable maps-backend.googleapis.com

快速开始

1.获取谷歌地图API密钥

1. 首选 谷歌云控制台>凭据
2. 新建API密钥或使用现有密钥
3. 将密钥限制为上面列出的所需API
4. 注意API密钥以进行部署

2.部署到云端运行

# Clone the repository
git clone 
cd google-maps-mcp-cloudrun

# Set your Google Maps API key
export GOOGLE_MAPS_API_KEY="your-api-key-here"

# Deploy using the provided script
./simple-deploy.sh your-gcp-project-id us-central1

3.提取服务URL

部署后，提取您的服务URL：

# Get the service URL
SERVICE_URL=$(gcloud run services describe google-maps-mcp \
  --region us-central1 \
  --format="value(status.url)")

echo "Your MCP Server URL: $SERVICE_URL/sse"

手动部署

如果您更喜欢手动部署：

# Set your project
gcloud config set project YOUR_PROJECT_ID

# Enable required services
gcloud services enable run.googleapis.com cloudbuild.googleapis.com

# Deploy
gcloud run deploy google-maps-mcp \
  --source . \
  --region us-central1 \
  --platform managed \
  --allow-unauthenticated \
  --set-env-vars GOOGLE_MAPS_API_KEY="your-api-key-here" \
  --memory 1Gi \
  --cpu 1 \
  --max-instances 10 \
  --timeout 300 \
  --port 8080

Claude桌面配置

将此配置添加到您的Claude Desktop设置中：

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://YOUR-SERVICE-URL.run.app/sse"
      ]
    }
  }
}

替换 YOUR-SERVICE-URL.run.app 使用您的实际Cloud Run服务URL。

查找您的Claude桌面配置

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%/Claude/claude_desktop_config.json

可用工具

MCP服务器为Claude提供以下工具：

1. 计算路由 -根据交通量计算最佳驾驶路线
2. 比较路线 -比较多条路线备选方案
3. get_live_traft -获取当前交通状况
4. 估算成本 -计算行程成本（燃料+通行费）

服务端点

• MCP端点: https://your-service.run.app/sse
• 健康检查: https://your-service.run.app/health
• 使用情况统计: https://your-service.run.app/stats

地方发展

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Edit .env with your API key
# GOOGLE_MAPS_API_KEY=your-api-key-here

# Start development server
npm run dev

# Test locally
npm test

故障排除

常见部署问题

1.拒绝许可

# Error: Permission denied
gcloud auth login
gcloud config set project YOUR_PROJECT_ID

2.API未启用

# Error: API not enabled
gcloud services enable run.googleapis.com
gcloud services enable cloudbuild.googleapis.com

3.未启用计费

• 访问 GCP计费控制台
• 为您的项目启用计费

4.API密钥无效

# Check API key restrictions in Console
# Ensure Directions API and Geocoding API are enabled

5.服务无法启动

# Check logs for errors
gcloud run services logs read google-maps-mcp --region us-central1 --limit 50

常见运行时问题

速率限制

• 每个IP每小时限制为50个请求
• 检查 /stats 当前使用的端点
• 考虑实施更高限制的用户身份验证

超过API配额

• 在中监控您的Google Maps API使用情况 GCP控制台
• 必要时增加配额
• 考虑为重复请求实现缓存

测试您的部署

# Test health endpoint
curl "https://your-service.run.app/health"

# Test stats endpoint
curl "https://your-service.run.app/stats"

# Test with Claude Desktop
# Add the configuration and try asking Claude to calculate a route

安全考虑

• API密钥存储为环境变量（安全）
• 服务允许公众访问（无需身份验证）
• 速率限制可防止滥用（每个IP每小时50个请求）
• 没有记录或存储敏感数据

成本管理

• 云运行：按请求付费定价
• 谷歌地图API：每个API-呼叫付费定价
• 监控：使用GCP计费警报来跟踪成本

设置账单提醒：

# Set up billing budget alerts in GCP Console
# Billing > Budgets & Alerts

文档链接

• 模型上下文协议（MCP）
• Google Cloud运行文档
• 谷歌地图平台文档
• Claude桌面MCP配置

支持和故障排除资源

• 云运行故障排除
• 谷歌地图API疑难解答
• GCP支持

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

______________________________________________________________________

备注：此服务器专为开发和测试目的而设计。对于高流量的生产使用，考虑实施额外的安全措施和监控。