🚀 GCP MCP 服务器
GCP MCP 服务器是一个模型上下文协议（MCP）服务器，它能让像 Claude 这样的 AI 助手与您的 Google Cloud Platform 环境进行交互。借助该服务器，您可以在对话过程中通过自然语言查询和管理 GCP 资源。
✨ 主要特性
- 🔍 支持使用自然语言查询和修改 GCP 资源。
- ☁️ 可支持多个 GCP 项目。
- 🌐 具备多区域支持能力。
- 🔐 采用安全的凭证处理方式，不会将凭证暴露给外部服务。
- 🏃♂️ 可在本地执行，使用您本地配置的 GCP 凭证。
- 🔄 具备自动重试机制，以提高系统的可靠性。
📦 安装指南
先决条件
- Node.js
- Claude Desktop/Cursor/Windsurf
- 本地配置好的 GCP 凭证（应用默认凭证）
安装步骤
- 克隆仓库：
git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp
- 安装依赖项：
npm install
📚 详细文档
配置
Claude Desktop
- 打开 Claude 桌面应用程序，转到设置 -> 开发者 -> 编辑配置。
- 将以下内容添加到
claude_desktop_config.json中： 通过 npm：
{
"mcpServers": {
"gcp": {
"command": "sh",
"args": ["-c", "npx -y gcp-mcp"]
}
}
}
如果是源代码安装：
{
"mcpServers": {
"gcp": {
"command": "npm",
"args": [
"--silent",
"--prefix",
"/path/to/gcp-mcp",
"start"
]
}
}
}
请将 /path/to/gcp-mcp 替换为实际项目目录路径。
Cursor
- 打开 Cursor，转到设置 (⌘,)。
- 导航至 AI -> 模型上下文协议。
- 添加一个新的 MCP 配置：
{
"gcp": {
"command": "npx -y gcp-mcp"
}
}
Windsurf
- 打开
~/.windsurf/config.json（如果不存在则创建）。 - 添加以下 MCP 配置：
{
"mcpServers": {
"gcp": {
"command": "npx -y gcp-mcp"
}
}
}
GCP 设置
- 配置 GCP 凭证：
- 使用
gcloud auth application-default login设置应用默认凭证。
- 使用
- 刷新您的 AI 助手（Claude Desktop/Cursor/Windsurf）。
使用说明
该服务器允许通过自然语言查询和管理 GCP 资源。以下是使用示例：
- 查询所有可用项目：
列出我所有的 GCP 项目 - 获取当前项目的 ID：
告诉我当前项目的 ID
可用工具
- gcp-mcp-server：用于启动 MCP 服务器。
- gcp-mcp-client：用于与 MCP 服务器交互的客户端工具。
示例互动
用户: 列出我所有的 GCP 项目
系统: 好的，以下是您拥有的所有 GCP 项目的列表：
1. project-12345
2. dev-environment
3. production-server
故障排除
如果遇到问题，请检查以下事项：
- 确保已启用所需的 GCP API。
- 验证您的账户是否有足够的权限访问资源。
- 检查日志文件以获取更多错误信息：
tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log
🤝 贡献
欢迎贡献！请随意提交拉取请求。
📄 许可证
MIT