Mcpheonix

🚀 MCPheonix

MCPheonixは、ElixirのPhoenixフレームワークを使用して実装されたModel Context Protocol（MCP）サーバーの簡易版です。このシステムは、AIモデルが統一インターフェースを通じてアプリケーションのデータや機能と相互作用できるようにします。

🚀 クイックスタート

MCPheonixを使用するには、以下の手順に従ってください。

前提条件

• Elixir 1.14以上
• Erlang 25以上
• Phoenix 1.7.0以上
• Python 3.9+（FluxとDartの統合に必要）
• Node.js 18+（Dart MCPサーバー用）
• Cloudflareアカウント（Durable Objectsの統合に必要）

インストール

1. リポジトリをクローンします。

git clone https://github.com/yourusername/mcpheonix.git
cd mcpheonix

2. 依存関係をインストールします。

mix deps.get

3. Cloudflareの統合を設定します。
   • cloudflare/durable-objects-worker.js のテンプレートを使用してCloudflare Workerを作成します。
   • あなたのCloudflareアカウントにデプロイします。
   • 以下の環境変数を設定します。
     • CLOUDFLARE_WORKER_URL：デプロイしたワーカーのURL
     • CLOUDFLARE_ACCOUNT_ID：あなたのCloudflareアカウントID
     • CLOUDFLARE_API_TOKEN：WorkersとDOの権限を持つAPIトークン
4. Fluxの統合を設定します（画像生成を使用する場合）。
   • Flux 統合のセクションに記載されている手順に従って、Flux CLI環境を設定します。
5. Dartの統合を設定します（タスク管理を使用する場合）。
   • Dart 統合のセクションに記載されている手順に従って、Dart MCPサーバーを設定します。
6. サーバーを起動します。

mix phx.server

サーバーは http://localhost:4001 で利用可能です。

カスタムMCPサーバーの追加

MCPheonixは、複数のMCPサーバーと連携するように設計されています。このシステムには、以下の方法でカスタムMCPサーバーを統合するための柔軟なアーキテクチャが含まれています。

1. シンプルなJSON設定：priv/config/mcp_servers.json でサーバー設定を定義します。

{
  "mcpServers": {
    "your_server_id": {
      "command": "/path/to/executable",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR1": "value1",
        "ENV_VAR2": "value2"
      },
      "tools": {
        "your_tool": {
          "description": "工具描述",
          "parameters": [
            { "name": "param1", "type": "string", "description": "参数描述" }
          ]
        }
      }
    }
  }
}

2. カスタムサーバー：必要に応じて MCPServer クラスを拡張して、カスタム機能をサポートします。

実装の詳細については、カスタムMCPサーバーのドキュメントを参照してください。

✨ 主な機能

• リアルタイム通知ストリーム（Server-Sent Events）
• クライアントリクエスト用のJSON-RPCエンドポイント
• シンプルなリソースシステム
• イベントの発行/購読メカニズム
• 基本的なツール呼び出し
• Flux画像生成の統合
• Dartタスク管理の統合
• 拡張性のあるMCPサーバーアーキテクチャ
• Cloudflare Durable Objectsによる自己修復分散アーキテクチャ
• Cloudflare Workersによるエッジコンピューティング能力

🔧 技術詳細

自己修復分散アーキテクチャ

MCPheonixは、Cloudflare Durable ObjectsとWorkersとの統合により、複雑な自我修復システムを実現し、障害に耐性があり、継続的な運用を保証する分散型の弾力性のあるアーキテクチャを構築しています。

主要コンポーネント

• Durable Objects：Cloudflareのグローバルエッジネットワーク上で動作する状態を持つサーバーレスコンポーネントで、障害が発生しても一貫性を維持します。
• エッジ分散：重要なアプリケーション状態がグローバルネットワークに複製され、地域の障害が発生しても中断しないようにします。
• 自動復旧：インスタンスが利用できなくなった場合、システムはdurableストレージ内の最新の状態から自動的に再作成します。
• リアルタイム通信：WebSocketのサポートにより、即時の復旧調整と状態同期が可能です。
• イベント駆動アーキテクチャ：コンポーネントは、発行/購読モデルを通じて状態の変化に反応し、システムが自己修復し、障害に適応できるようにします。

実装の詳細については、Cloudflare 統合のドキュメントを参照してください。

💻 使用例

基本的な使用法

以下は、MCPheonixを起動する基本的なコマンドの例です。

# サーバーを起動する
mix phx.server

高度な使用法

カスタムMCPサーバーを追加する場合、priv/config/mcp_servers.json を設定することができます。

{
  "mcpServers": {
    "your_server_id": {
      "command": "/path/to/executable",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR1": "value1",
        "ENV_VAR2": "value2"
      },
      "tools": {
        "your_tool": {
          "description": "工具描述",
          "parameters": [
            { "name": "param1", "type": "string", "description": "参数描述" }
          ]
        }
      }
    }
  }
}