MCP Fly Deployer

🚀 MCP 飛行部署器

MCP 飛行部署器是一款專門的配置生成工具，用於將模型上下文協議（MCP）服務器部署到 Fly.io。它能自動化創建 Dockerfile、fly.toml 配置和部署腳本，尤其適用於基於標準輸入輸出（stdio）的 MCP 服務器。該項目集成了 supergateway，可讓 MCP stdio 服務器通過 SSE（服務器發送事件）或 WebSocket 進行通信，從而無縫部署到 Fly.io 的基礎設施中。

🚀 快速開始

安裝

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 上
# 或者在 Windows 上
.venv\Scripts\activate

3. 安裝依賴項：

uv sync

使用方法

1. 啟動 MCP 服務器：

python mcp_server_generator.py

該服務器將在默認端口 8000 上運行，使用 SSE（服務器發送事件）傳輸。

2. 發送請求以生成部署計劃，參數如下：

{
    "server_command": "node",              # 運行目標 stdio 服務器的命令
    "server_args": ["index.js"],           # 服務器命令的參數
    "runtime": "node",                     # 運行時類型（'python', 'node', 'go', 'binary'）
    "runtime_version": "20",               # 特定運行時版本
    "dependencies": [],                    # 依賴項列表
    "environment_variables": {},           # 環境變量
    "region": "us-east-1",                 # 部署區域
    "fly_app_id": "your_fly_app_id"        # Fly 應用程序 ID
}

✨ 主要特性

• 🚀 自動化生成 Fly.io 部署配置
• 🐳 根據運行時動態生成 Dockerfile
• ⚙️ 可自定義的 fly.toml 配置
• 🔧 支持多種運行時：
  • Python
  • Node.js
  • Go
  • 自定義二進制文件
• 🔑 環境變量和機密管理
• 🌐 可配置的區域和部署選項

🔧 技術細節

工作原理

MCP 飛行部署器利用 supergateway 來：

• 將 stdio 基於的 MCP 服務器轉換為 SSE 或 WebSocket 服務
• 實現遠程訪問和調試功能
• 自動管理 JSON-RPC 版本控制
• 處理包元數據傳輸

有關底層網關技術的詳細信息，請參閱 supergateway 文檔。

先決條件

• Python 3.13 或更高版本
• pip（Python 包管理器）
• 已安裝並配置好的 Fly.io CLI
• Node.js 和 npm（用於 supergateway 功能）

配置選項

支持的運行時

• Python: 使用 python 運行時。
• Node.js: 使用 node 運行時，版本指定為 16, 18 等等。
• Go: 使用 go 運行時，版本指定為 1.20 等等。
• 自定義二進制文件: 部署自定義構建的二進制文件。

區域

支持以下 Fly.io 區域：

• us-east-1
• us-west-2
• eu-central-1

📚 詳細文檔

開發和貢獻

要為項目做出貢獻，請參考 CONTRIBUTING.md。

問題報告

遇到問題或有疑問？請在 Issues 中提交問題。