Mcpheonix

🚀 MCPheonix

MCPheonix 是一個藉助 Elixir 的 Phoenix 框架實現的簡化版 Model Context Protocol（MCP）服務器。它構建了一個智能、自我修復且分佈式的 AI 事件系統，讓 AI 模型能通過統一接口與應用程序的數據和功能進行交互。

🚀 快速開始

先決條件

• 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 全球邊緣網絡上運行的狀態ful 無服務器組件，即使在故障情況下也能保持一致性。
• 邊緣分發：關鍵應用狀態在全球網絡中複製，確保即使區域故障也不會中斷。
• 自動恢復：如果一個實例不可用，系統會自動從 durable 存儲中的最新狀態重新創建它。
• 即時通信：WebSocket 支持實現了即時恢復協調和狀態同步。
• 事件驅動架構：組件通過發佈/訂閱模型對狀態變化做出反應，允許系統自我修復並適應故障。

有關實現的詳細信息，請參閱Cloudflare 集成文檔。

💻 使用示例

基礎用法

在配置好環境並啟動服務器後，你可以通過以下方式與 MCPheonix 進行交互：

# 示例命令，根據實際情況調整
curl http://localhost:4001/api/your_endpoint

高級用法

如果你需要集成自定義 MCP 服務器，可以按照以下步驟操作：

{
  "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": "參數描述" }
          ]
        }
      }
    }
  }
}

詳細的實現信息可參考自定義 MCP 服務器文檔。