🚀 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 服务器文档。