基本能力
产品定位
GCP MCP 是一个桥接AI助手和Google Cloud Platform的工具,旨在通过自然语言简化GCP资源的管理和查询。
核心功能
- 使用自然语言查询和修改GCP资源
- 支持多个GCP项目
- 多区域支持
- 安全的凭据处理(不向外部服务暴露凭据)
- 使用本地GCP凭据执行
- 自动重试以提高可靠性
适用场景
- 通过自然语言快速查询GCP资源状态
- 在对话中直接管理GCP资源
- 自动化GCP资源管理流程
工具列表
run-gcp-code
: 使用TypeScript代码执行GCP API调用list-projects
: 列出所有可访问的GCP项目select-project
: 为后续操作选择一个GCP项目get-billing-info
: 获取当前项目的账单信息get-cost-forecast
: 获取当前项目的成本预测get-billing-budget
: 获取当前项目的账单预算list-gke-clusters
: 列出当前项目中的所有GKE集群list-sql-instances
: 列出当前项目中的所有Cloud SQL实例get-logs
: 获取当前项目的Cloud Logging条目
常见问题解答
- 认证错误:确保已运行
gcloud auth application-default login
- 权限错误:检查您账户的IAM角色
- API错误:验证所需API是否在您的项目中启用
使用教程
使用依赖
- Node.js
- Claude Desktop/Cursor/Windsurf
- 本地配置的GCP凭据(应用程序默认凭据)
安装教程
- 克隆仓库:
bash
git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp - 安装依赖:
bash
npm install
配置
Claude Desktop
- 打开Claude桌面应用,转到Settings -> Developer -> Edit Config
- 在
claude_desktop_config.json
中添加配置
Cursor
- 打开Cursor,转到Settings (⌘,)
- 导航到AI -> Model Context Protocol
- 添加新的MCP配置
Windsurf
- 打开
~/.windsurf/config.json
(如不存在则创建) - 添加MCP配置
GCP设置
- 设置GCP凭据:
bash
gcloud auth application-default login - 刷新您的AI助手(Claude Desktop/Cursor/Windsurf)
调试方式
查看日志:
bash
tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log