MCP Fly Deployer

MCP Fly Deployer

site icon
2025.04.14 0
Python部署工具自动化工具开发效率
MCP Fly Deployer 是一个专门用于将 Model Context Protocol (MCP) 服务器部署到 Fly.io 的配置生成工具。它自动化了 Dockerfiles、fly.toml 配置和部署脚本的创建过程,支持基于 stdio 的 MCP 服务器。该工具通过集成 supergateway,使 MCP stdio 服务器能够通过 SSE (Server-Sent Events) 或 WebSockets 进行通信,从而无缝部署到 Fly.io 的基础设施上。
View on GitHub

Overview

基本能力

产品定位

MCP Fly Deployer 是一个自动化部署工具,专门用于将 MCP 服务器部署到 Fly.io 平台。

核心功能

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

适用场景

  • 需要将 MCP stdio 服务器部署到 Fly.io 的开发人员
  • 需要自动化部署流程的团队
  • 需要支持多种运行时的项目

工具列表

  • supergateway:用于将 stdio 服务器转换为 SSE 或 WebSocket 服务,支持远程访问和调试。

常见问题解答

  • 问题:如何指定运行时版本? 解答:在请求参数中通过 runtime_version 指定。
  • 问题:如何设置部署区域? 解答:通过 primary_region 参数指定 Fly.io 区域。

使用教程

使用依赖

  • 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
  1. 创建并激活虚拟环境:
python -m venv .venv
source .venv/bin/activate  # 在 Unix/macOS 上
# 或者
.venv\Scripts\activate     # 在 Windows 上
  1. 安装依赖:
uv sync

调试方式

  1. 启动 MCP 服务器:
python mcp_server_generator.py
  1. 发送请求以生成部署计划,参数示例:
{
    "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"
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。