Google Cloud MCP 服务器

一个模型上下文协议服务器，连接到 Google Cloud 服务，为与您的 Google Cloud 资源交互提供上下文和工具。

服务

支持的服务：

• [x] Google Cloud Logging
• [x] Google Cloud Monitoring
• [x] Google Cloud Spanner

开发中的服务器：

• [ ] Google Cloud Trace
• [ ] Google IAM
• [ ] Google Cloud Compute
• [ ] Google Cloud Run
• [ ] Google Cloud Storage

Google Cloud Logging

查询和过滤来自 Google Cloud Logging 的日志条目：

• 使用自定义过滤器查询日志
• 在特定时间范围内搜索日志
• 以可读格式格式化和显示日志条目

Google Cloud Spanner

与 Google Cloud Spanner 数据库交互：

• 对 Spanner 数据库执行 SQL 查询
• 列出可用的数据库和表
• 浏览数据库模式

Google Cloud Monitoring

检索和分析来自 Google Cloud Monitoring 的指标：

• 使用自定义过滤器查询指标
• 随时间可视化指标数据
• 列出可用的指标类型

Google Cloud Trace

分析来自 Google Cloud Trace 的分布式跟踪：

• 按 ID 检索跟踪
• 列出带有过滤选项的最近跟踪
• 查找与日志关联的跟踪
• 识别失败的跟踪
• 使用自然语言查询跟踪（例如，“显示我过去一小时内失败的跟踪”）

身份验证

此服务器支持两种使用 Google Cloud 进行身份验证的方法：

1. 服务帐户密钥文件（推荐）：将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务帐户密钥文件的路径。 这是标准的 Google Cloud 身份验证方法。

2. 环境变量：直接设置 GOOGLE_CLIENT_EMAIL 和 GOOGLE_PRIVATE_KEY 环境变量。 这对于存储密钥文件不切实际的环境很有用。

如果设置了 GOOGLE_CLOUD_PROJECT 环境变量，服务器也会使用它，否则它将尝试从身份验证凭据中确定项目 ID。

安装

# 克隆存储库
git clone https://github.com/krzko/google-cloud-mcp.git
cd google-cloud-mcp

# 安装依赖
pnpm install

# 构建
pnpm build

向 Google Cloud 验证身份：

gcloud auth application-default login

在您的客户端中配置 mcpServers：

{
  "mcpServers": {
      "google-cloud-mcp": {
          "command": "node",
          "args": [
              "/Users/foo/code/google-cloud-mcp/dist/index.js"
          ],
          "env": {
              "GOOGLE_APPLICATION_CREDENTIALS": "/Users/foo/.config/gcloud/application_default_credentials.json"
          }
      }
  }
}

开发

启动服务器

# 构建项目
pnpm build

# 启动服务器
pnpm start

开发模式

# 构建项目
pnpm build

# 启动服务器和检查器
npx -y @modelcontextprotocol/inspector node dist/index.js

与 Smithery 一起使用（即将推出）

此服务器可以部署并与 Smithery 一起使用。 该服务器实现了身份验证的延迟加载，这意味着它将立即启动并在实际需要时才进行身份验证。 操作仍然需要身份验证，但这种方法可以防止服务器初始化期间的超时。

注意：Smithery 本地服务器支持目前正在开发中，可能尚未可用。

故障排除

服务器超时问题

如果在 Smithery 中运行服务器时遇到超时问题，请尝试以下操作：

1. 通过在配置中设置 debug: true 来启用调试日志记录
2. 确保设置了 lazyAuth: true 以延迟身份验证，直到实际需要时才进行
3. 确保您的凭据文件可访问且有效
4. 检查日志中是否有任何错误消息

重要提示：操作仍然需要身份验证，但启用延迟加载后，服务器将立即启动并在需要时进行身份验证，而不是在初始化期间进行身份验证。

身份验证问题

服务器支持两种身份验证方法：

1. 服务帐户密钥文件：将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务帐户密钥文件的路径
2. 环境变量：设置 GOOGLE_CLIENT_EMAIL 和 GOOGLE_PRIVATE_KEY 环境变量

如果您遇到身份验证问题，请确保：

• 您的服务帐户具有必要的权限
• 密钥文件格式正确且可访问
• 环境变量已正确设置