AI导哈

服务器部署工具

MCP Launcher 是一个本地 Web 仪表板，用于构建、部署和监控 Google Cloud Run 上的 MCP（Model Context Protocol）服务器。用户只需指向服务器代码并点击部署，即可获得实时 URL。

  • by XamHans
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 XamHans/mcp-launcher

使用说明

mcp发射器

只需一个命令即可将MCP服务器部署到Google Cloud Run。

npx mcp-launcher

它做什么

MCP Launcher为您提供了一个本地web仪表板，用于在Google Cloud Run上构建、部署和监控MCP（模型上下文协议）服务器。您将它指向您的服务器代码，单击部署，并获得一个实时URL。

当你运行它时会发生什么

npx mcp-launcher
  1. 检查先决条件 --确保 gcloud 和 docker 已安装并正在运行
  2. 询问您的Google Cloud项目ID --这是将部署MCP服务器的GCP项目。Cloud Run、Artifact Registry和Cloud Build都在这个项目下运行。你可以在以下网址找到它 console.cloud.google.com
  3. 询问您的人类API密钥 （可选）--用于内置代理/审计功能。您可以跳过此步骤，稍后从仪表板设置中添加
  4. 启动仪表板 在 http://localhost:3000

在仪表板上，您可以：

  • 添加MCP服务器（指向包含代码的目录）
  • 一键部署到Cloud Run
  • 实时监控健康状况、指标和日志
  • 检查和测试您的MCP工具、资源和提示

开始之前

您需要安装三件事：

工具 为什么 安装
Node.js 18+ 运行启动器 nodejs.org
谷歌云SDK 部署到云端运行 cloud.google.com/sdk
码头工人 构建容器映像 docker.com

然后设置GCP：

gcloud auth login
gcloud config set project YOUR_PROJECT_ID
gcloud services enable run.googleapis.com artifactregistry.googleapis.com cloudbuild.googleapis.com

配置

启动器将您的设置保存到 .env 文件位于当前目录中，因此您不必重新输入它们。

你也可以通过旗帜传递一切：

npx mcp-launcher --project my-project-id --api-key sk-ant-... --port 8080
标志 描述
--project <id> 谷歌云项目ID
--api-key <key> 无烟煤API密钥
--port <number> 服务器端口（默认值：3000）
--no-browser 不要自动打开浏览器
--save-config 将设置保存到 .env

部署是如何工作的

当您在仪表板中单击“部署”时：

  1. 从MCP服务器代码构建Docker镜像
  2. 将其推送到谷歌工件注册表
  3. 通过自动扩展部署到Cloud Run
  4. 验证服务是否处于活动状态，并向您提供URL

部署的服务器是一个标准的Cloud Run服务，您可以像其他服务一样从GCP控制台管理它。

健康检查

仪表板会轮询您部署的服务，以检查它们是否仍在运行。如果服务出现故障（例如，从GCP控制台中删除），状态将切换为 不健康的 诊断面板显示出了问题所在。

您可以在服务器详细信息页面上的可观察性设置卡中配置每台服务器的轮询间隔。

包含模板

这 template/ 该目录有一个工作的Python MCP服务器（使用FastMCP），您可以立即部署以进行测试。它包括示例工具、资源和提示。

故障排除

端口已在使用中 --另一个进程在端口3000上。使用 --port 8080 或者终止现有进程。

Docker未运行 --启动Docker桌面，或在Linux上： sudo systemctl start docker

gcloud未通过身份验证 --奔跑 gcloud auth login 和 gcloud auth configure-docker

GCP上的权限被拒绝 --您的帐户需要云运行管理员、工件注册表管理员和服务帐户用户角色。

许可证

国际学生委员会

相关 MCP