MCPheonix

基本能力

产品定位

MCPhoenix是一个智能、自愈、分布式的AI事件系统，通过Model Context Protocol和Elixir Phoenix框架实现，为AI模型与应用程序提供统一的交互接口。

核心功能

• Server-Sent Events (SSE) 流，用于实时通知
• JSON-RPC 端点，用于客户端请求
• 简单的资源系统
• 事件发布/订阅机制
• 基本工具调用
• Flux 图像生成集成
• Dart 任务管理集成
• 可扩展的MCP服务器架构
• 通过Cloudflare Durable Objects实现的自愈分布式架构
• 通过Cloudflare Workers实现的边缘计算能力

适用场景

• 需要实时交互的AI应用
• 分布式系统，需要高可用性和自愈能力
• 边缘计算场景
• 需要集成多种工具和服务的AI平台

工具列表

• Flux图像生成集成：支持图像生成功能
• Dart任务管理集成：支持任务管理功能
• JSON-RPC端点：处理客户端请求
• SSE流：提供实时通知

常见问题解答

• 如何配置Cloudflare集成？参考Cloudflare Integration文档
• 如何添加自定义MCP服务器？参考Adding MCP Servers文档

使用教程

使用依赖

• 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

1. 安装依赖

mix deps.get

1. 配置Cloudflare集成
2. 使用cloudflare/durable-objects-worker.js模板创建Cloudflare Worker
3. 部署到Cloudflare账户

4. 设置环境变量：

   • CLOUDFLARE_WORKER_URL：部署的worker URL
   • CLOUDFLARE_ACCOUNT_ID：Cloudflare账户ID
   • CLOUDFLARE_API_TOKEN：具有Workers和DO权限的API令牌

5. 配置Flux集成（如果使用图像生成）

6. 按照Flux Integration部分设置Flux CLI环境

7. 配置Dart集成（如果使用任务管理）

8. 按照Dart Integration部分设置Dart MCP服务器

9. 启动服务器

mix phx.server

服务器将在http://localhost:4001上可用。

调试方式

• 检查服务器日志以查看启动和运行状态
• 使用curl或Postman测试SSE和JSON-RPC端点
• 参考文档中的故障排除部分

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。