MCP Fly 部署器

一个专门用于将模型上下文协议 (MCP) 服务器部署到 Fly.io 的配置生成器。此工具可自动创建基于 stdio 的 MCP 服务器的 Dockerfile、fly.toml 配置和部署脚本。

本项目集成了 supergateway，使 MCP stdio 服务器能够通过 SSE（服务器发送事件）或 WebSockets 进行通信，从而方便地部署到 Fly.io 的基础设施。

特性

• 🚀 自动化 Fly.io 部署配置生成
• 🐳 基于运行时的动态 Dockerfile 生成
• ⚙️ 可定制的 fly.toml 配置
• 🔧 支持多种运行时：
  • Python
  • Node.js
  • Go
  • 自定义二进制文件
• 🔑 环境变量和密钥管理
• 🌐 可配置的区域和部署选项

工作原理

MCP Fly 部署器使用 supergateway 来：

• 将基于 stdio 的 MCP 服务器转换为 SSE 或 WebSocket 服务
• 启用远程访问和调试功能
• 自动管理 JSON-RPC 版本控制
• 处理包元数据传输

有关底层网关技术的更多详细信息，请参阅 supergateway 文档。

前提条件

• Python 3.13 或更高版本
• pip (Python 包管理器)
• 已安装并配置 Fly.io CLI
• Node.js 和 npm（用于 supergateway 功能）

安装

1. 克隆存储库：

git clone https://github.com/yourusername/mcp-fly-deployer.git
cd mcp-fly-deployer

2. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # 在 Unix/macOS 上
# OR
.venv\Scripts\activate     # 在 Windows 上

3. 安装依赖项：

uv sync

用法

1. 启动 MCP 服务器：

python mcp_server_generator.py

默认情况下，服务器将使用 SSE（服务器发送事件）传输在端口 8000 上启动。

2. 发送请求以生成具有以下参数的部署计划：

{
    "server_command": "node",              # 运行目标 stdio 服务器的命令
    "server_args": ["index.js"],           # 服务器命令的参数
    "runtime": "node",                     # 运行时 ('python', 'node', 'go', 'binary')
    "runtime_version": "20",               # 特定运行时版本
    "dependencies": [],                    # 依赖项列表
    "requirements_file_content": None,     # Python 的 requirements.txt 的内容
    "files_to_create": [],                # 要在镜像中创建的文件
    "required_env_vars": [],              # 必需的环境变量
    "target_port": 8000,                  # 容器将监听的端口（默认：8000）
    "app_name": "mcp-server-app",         # 建议的 Fly.io 应用程序名称
    "primary_region": "ord"               # 建议的 Fly.io 主要区域
}

配置选项

支持的运行时

• python: 具有版本规范的 Python 运行时
• node: 具有版本规范的 Node.js 运行时
• go: Go 运行时
• binary: 自定义二进制文件部署

部署区域

可以使用 primary_region 参数指定 Fly.io 区域。 常用选项：

• ord: 芝加哥
• iad: 北弗吉尼亚
• dfw: 达拉斯
• lax: 洛杉矶
• bom: 孟买

示例

这是一个为 Node.js MCP 服务器生成部署计划的简单示例：

{
    "server_command": "node",
    "server_args": ["index.js"],
    "runtime": "node",
    "runtime_version": "20",
    "dependencies": ["@modelcontextprotocol/server"],
    "target_port": 8080,
    "app_name": "my-mcp-server",
    "primary_region": "ord"
}

开发

要为项目做出贡献：

1. Fork 存储库
2. 创建一个功能分支
3. 进行更改
4. 提交拉取请求

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参见 LICENSE 文件。

贡献

欢迎贡献！ 请随时提交拉取请求。

支持

如果您遇到任何问题或有疑问，请打开一个 issue。