Google Cloud DevOps MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个本地 MCP 服务器，用于将 Google Cloud DevOps 相关的能力以 MCP 形式暴露给 LLM 客户端。服务器注册并暴露多种工具以操作云服务（如 Cloud Build、Artifact Registry、Cloud Run、Cloud Storage、OSV 安全扫描等），并提供 Prompts 以引导与渲染与 DevOps 流程相关的对话。

• 主要功能点

  • MCP 服务器实现与注册：核心是基于 MCP 的服务端，能够处理 JSON-RPC 风格的请求与响应，支持多种传输方式。
  • 资源与工具管理：提供资源读取、数据访问能力，以及工具的注册、执行能力，便于 LLM 调用外部功能。
  • Prompt 定义与渲染：定义并渲染用于与 LLM 交互的 Prompt 模板，支持可定制的对话模式。
  • 安全与会话管理：具备会话管理、能力声明等能力，考虑安全性与最小权限原则。
  • 多传输协议支持：默认以 STDIO 方式运行，也支持通过 streamable HTTP（SSE/WebSocket）等传输协议扩展。

• 安装步骤（简化）

  • 需要已安装 Go 语言环境。
  • 构建服务端：在仓库根目录执行构建命令，生成可执行文件（如 devops-mcp-server）。
  • 运行方式：
    • 纯 STDIO 模式（默认）：直接运行生成的二进制程序，服务器通过标准输入输出与客户端通信。
    • 流式 HTTP 模式：使用 --http 指定地址，如 --http=0.0.0.0:8080；服务器将以流式 HTTP 方式对外提供 MCP 服务。
  • 运行示例（步骤性描述，非代码块）：
    • 构建完成后执行可执行文件，默认进入 STDIO 模式。
    • 如需 HTTP 传输，传入 http 参数指定监听地址；若未提供，保持 STDIO 通信。

• 服务器配置（MCP 客户端需要的最小信息） 为了让 MCP 客户端与服务器建立连接，需提供以下配置（JSON 格式，描述性注释在注释字段中给出）： { "server_name": "devops", "command": "./devops-mcp-server", "args": { "http": "", // 为空表示使用 STDIO 通信；若需要通过流式 HTTP，请提供监听地址，例如 "0.0.0.0:8080" "pprof": "" // 可选，用于开启性能分析端口，例如 ":6060" }, "notes": "默认使用 STDIO 通信，若要启用流式 HTTP，请在 http 字段填写监听地址；pprof 用于调试与性能分析。" }

• 基本使用方法

  1. 启动服务器：按照上面的安装步骤构建并运行。若使用 HTTP 模式，请确保网络可访问指定地址。
  2. 与客户端连接：在 MCP 客户端中配置服务器信息（名称、启动命令及参数如上所示），客户端会通过 MCP 协议向服务器发送请求并接收响应。
  3. 调用工具与获取结果：LLM 客户端通过 MCP 发送对工具的调用请求，服务器执行对应云服务操作并返回结果。
  4. 使用 Prompts：客户端可以请求服务器提供的 Prompts，用于引导 LLM 进行特定的工作流（如设计 CI/CD、部署、资源查询等）。
  5. 安全注意：在实际生产中，请注意对服务账户、权限范围以及输入的安全性与最小权限原则的遵循。