MCP Fly Deployer

🚀 MCP フライデプロイヤー

このツールは、モデルコンテキストプロトコル（MCP）サーバーを Fly.io にデプロイするための設定を自動生成します。標準入出力（stdio）ベースの MCP サーバーに対応しており、Dockerfile、fly.toml 設定、およびデプロイスクリプトを自動的に作成します。

このプロジェクトは supergateway を統合しており、MCP stdio サーバーが SSE（サーバー送信イベント）または WebSocket を介して通信できるようにし、Fly.io のインフラストラクチャにシームレスにデプロイできるようにしています。

✨ 主な機能

• 🚀 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 機能に必要）

手順

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
}

📚 ドキュメント

サポートされるランタイム

• 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 で問題を提出してください。