关键词

Cloud Run 部署AI 代理集成Google Cloud 管理LLM 工具应用部署

项目简介

Google Cloud Run MCP 服务端是一个后端应用，它使AI代理和大型语言模型（LLM）客户端能够以标准化方式与Google Cloud Run服务进行交互。它通过提供工具来管理Cloud Run上的部署、服务列表和日志，并提供简化的Prompt模板来自动化常见操作，从而简化了AI驱动型应用在Google Cloud上的开发和部署。

主要功能点

  • 部署服务: 允许通过上传本地文件夹、提供文件内容或指定容器镜像URL来部署应用到Google Cloud Run。
  • 服务管理: 列出特定 Google Cloud 项目中的所有 Cloud Run 服务，并获取任何特定服务的详细信息（如URL、上次部署信息）。
  • 日志查询: 获取特定 Cloud Run 服务的运行日志和错误消息，以便进行故障排除和监控。
  • 项目管理: 能够列出所有可访问的 Google Cloud 项目，并支持创建新的 Google Cloud 项目并尝试自动绑定到可用的计费账户。
  • Prompt 模板: 提供预定义的自然语言指令（例如 'deploy' 和 'logs'），作为执行工具调用的快捷方式，简化与 Cloud Run 服务的交互。

安装步骤

该 MCP 服务端可以通过 Node.js 或 Docker 在本地运行。这里提供本地 Node.js 的安装步骤：

  1. 安装 Node.js: 确保您的系统已安装 Node.js (推荐 LTS 版本)。
  2. 安装 Google Cloud SDK: 访问 Google Cloud SDK 文档 并按照指引进行安装。
  3. 登录 Google Cloud 账户: 打开终端，运行命令 'gcloud auth login' 并按照提示完成认证。
  4. 设置应用默认凭据 (ADC): 在终端运行命令 'gcloud auth application-default login'，这将为您的应用设置默认的身份验证凭据。

服务器配置

MCP 客户端需要配置此 MCP 服务端的连接信息。以下是一个典型的 JSON 配置示例，您需要将其添加到您的 MCP 客户端的配置文件中（具体位置和格式请参考您的客户端文档）。

{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": ["-y", "@google-cloud/cloud-run-mcp"],
      // 可选：设置环境变量，以提供默认的 Google Cloud 项目、区域和服务名称。
      "env": {
        "GOOGLE_CLOUD_PROJECT": "YOUR_GCP_PROJECT_ID",   // 替换为您的 Google Cloud 项目 ID
        "GOOGLE_CLOUD_REGION": "YOUR_GCP_REGION",       // 替换为部署的区域，例如 "europe-west1"
        "DEFAULT_SERVICE_NAME": "YOUR_SERVICE_NAME"     // 替换为默认的服务名称
      }
    }
  }
}
  • 'cloud-run': 这是您为该 MCP 服务端定义的名称，您的客户端将通过此名称引用它。
  • 'command': 用于启动 MCP 服务端的命令。'npx' 是 Node.js 的一个工具，用于运行 Node.js 包而无需全局安装。
  • 'args': 传递给 'command' 的参数。'-y' 允许 'npx' 自动安装所需的包，'@google-cloud/cloud-run-mcp' 是该 MCP 服务端的 Node.js 包名。
  • 'env': (可选) 这是一个环境变量集合，用于为所有 Cloud Run 操作设置默认的 Google Cloud 项目、区域和默认服务名称。这可以减少在每次调用工具时手动指定这些参数的需要。

基本使用方法

一旦 MCP 客户端配置完成，您就可以通过客户端的界面或命令与该 MCP 服务端进行交互。例如，在支持的 AI 助手中，您可以使用自然语言指令：

  • 部署应用程序: “将此文件夹部署到 Cloud Run，服务名为 'my-web-app'，区域为 'us-central1'，项目为 'my-gcp-project'。”
  • 查看服务日志: “显示 'my-gcp-project' 项目中 'europe-west1' 区域 'my-web-app' 服务的最新日志。”
  • 列出所有服务: “列出 'my-gcp-project' 中的所有 Cloud Run 服务。”
  • 创建新项目: “创建一个名为 'my-new-project-id' 的 Google Cloud 项目。”

信息

分类

开发者工具

访问项目