cloud run MCP proxy

云运行MCP代理

访问GCP Cloud Run上运行的远程MCP服务器的代理。

该项目提供了一种安全访问部署在Google Cloud Run上的模型上下文协议（MCP）服务器的方法。它处理身份验证并将请求代理到相应的Cloud Run服务。

使用此MCP服务器

您可以在MCP服务器定义中使用以下条目

{
    "mcpServers": {
        "mcp-contract-registry": {
        "disabled": false,
        "timeout": 60,
        "type": "stdio",
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "CLOUD_RUN_MCP_SERVER_URL",
            "-e",
            "GOOGLE_APPLICATION_CREDENTIALS",
            "--mount",
            "type=bind,source=/home/vscode/.config/gcloud,target=/app/.config/gcloud,ro",
            "jhginn/cloud-run-mcp-proxy:latest" // Or use a date tag from https://hub.docker.com/repository/docker/jhginn/cloud-run-mcp-proxy/general
        ],
        "env": {
            "CLOUD_RUN_MCP_SERVER_URL": "https://www.my.app.url.com",
            "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/.config/gcloud/application_default_credentials.json"
        }
        }
    }
}

确保：

• 在主机设备上登录gcloud
• 使用正确的GOOGLE_APPLICATION_CREDENTIALS路径。通常，这是您的主目录。

这仅适用于使用 Streamable HTTP transport，并使用IAM进行保护。

开发人员入门指南

本指南将帮助您为当地发展建立项目。

先决条件

• Python>=3.12
• 紫外线 （Python包安装程序）
• 码头工人 （用于建造集装箱）
• 仅仅 （命令执行器）

设置

1. 克隆存储库：

   git clone 
   cd cloud_run_mcp_proxy

1. 安装依赖关系和预提交钩子：

此项目使用 uv 用于包管理和 just 作为一名命令执行者。

   just setup

此命令是的别名 just install （运行 uv sync --all-groups)以及 just pre_commit_setup （运行 uv run pre-commit install).

通用开发命令

这 justfile 在项目的根目录中定义了几个有用的命令：

• just install：安装/更新Python依赖项。
• just pre_commit_setup：安装预提交挂钩。
• just setup （或 just s)：一个方便的别名来运行这两个 install 和 pre_commit_setup.
• just pre_commit （或 just p)：对所有文件运行预提交检查。
• just test （或 just t)：使用运行测试 pytest.
• just build：为代理构建Docker容器。

运行代理

可以使用中定义的入口点脚本运行代理 pyproject.toml:

cloud_run_mcp_proxy

（随着项目的发展，将在此处添加有关配置和部署的更多详细信息。）

项目结构

• src/cloud_run_mcp_proxy/：包含代理的主要源代码。

- proxy.py：核心代理逻辑。 - auth.py：处理与Google Cloud的身份验证。

• tests/：包含单元和集成测试。
• Dockerfile：定义用于部署代理的Docker镜像。
• justfile：包含常用的开发命令。
• pyproject.toml：定义项目元数据、依赖关系和生成系统配置。