acuvity/mcp-server-google-maps

mcp-server-google-maps 镜像说明

镜像概述

本镜像为基于Model Context Protocol（MCP）的Google Maps API调用服务器，由Acuvity打包并发布。它源自@modelcontextprotocol/server-google-maps的原始源码，提供安全可靠的运行环境，支持IDE集成、Kubernetes部署等多种使用场景。

核心功能

安全隔离沙箱

• 隔离执行：工具在容器化沙箱中运行，防止横向渗透。
• 非root默认：遵循最小权限原则，降低漏洞影响范围。
• 只读文件系统：确保运行时不可变性，避免未授权修改。
• 版本固定：锁定依赖版本，保证部署一致性和可复现性。
• CVE扫描：通过Docker Scout持续检测已知漏洞。
• 供应链透明：嵌入SBOM和溯源信息，支持供应链安全审计。
• 镜像签名：使用Cosign签名，验证镜像完整性和真实性。

运行时防护

• Minibridge集成：提供安全的Agent-MCP连接，支持Rego/HTTP策略控制。
• 防护规则：包含资源完整性校验、隐蔽指令检测、敏感数据识别等（默认仅启用资源完整性，可按需配置）。

使用场景

• IDE集成：为VS Code、Cursor等工具提供Google Maps API访问能力。
• Agentic系统：作为MCP服务器，安全调用Google Maps服务。
• 集群部署：在Kubernetes中为内部服务提供稳定的API端点。

配置说明

环境变量

• GOOGLE_MAPS_API_KEY：必填，Google Maps API访问密钥。

Docker部署示例

本地STDIO模式

客户端配置参数：

• 命令：docker
• 参数：run -i --rm --read-only -e GOOGLE_MAPS_API_KEY docker.io/acuvity/mcp-server-google-maps:0.6.2

本地HTTP/SSE模式

bash
docker run -it -p 8000:8000 --rm --read-only -e GOOGLE_MAPS_API_KEY docker.io/acuvity/mcp-server-google-maps:0.6.2

客户端配置：

json
{
  "mcpServers": {
    "acuvity-mcp-server-google-maps": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Kubernetes部署（Helm）

安装Chart

bash
helm install mcp-server-google-maps oci://docker.io/acuvity/mcp-server-google-maps --version 1.0.0

需提前设置GOOGLE_MAPS_API_KEY为Kubernetes Secret。

客户端集成

支持VS Code、Windsurf IDE、Cursor IDE、Claude Desktop、OpenAI Python SDK等，具体配置可参考官方文档。 ===FULL_DESC===