Coreflux MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，它连接到 Coreflux MQTT 代理，并将 Coreflux 操作作为工具提供给 Claude 和其他 MCP 兼容的 AI 助手。

功能

• 连接到 Coreflux MQTT 代理
• 为所有 Coreflux 命令（模型、操作、规则、路由）提供工具
• 发现并列出可用的操作
• 包含 LOT 语言文档作为资源
• 使用官方 MCP SDK 构建，实现无缝 Claude 集成

快速开始

使用 Docker Compose (推荐)

1. 复制示例环境变量文件：

   cp .env.example .env
   

2. 编辑 .env 文件，填写您的 MQTT 代理详细信息：

   MQTT_BROKER=您的代理地址
   MQTT_PORT=1883
   MQTT_USER=您的用户名
   MQTT_PASSWORD=您的密码
   

3. 使用 docker-compose 运行：

   docker-compose up -d
   

使用 Python (本地开发)

1. 安装 MCP SDK 和所需的依赖项：

   pip install "mcp[cli]" paho-mqtt
   

2. 使用环境变量运行服务器：

   MQTT_BROKER=您的代理地址 MQTT_PORT=1883 python server.py
   

将 Claude 连接到 MCP 服务器

推荐方法：使用 Claude Desktop Config

1. 创建或编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS/Linux) 或等效的 Windows 路径
2. 添加以下配置（根据需要调整路径）：

   {
     "mcpServers": {
       "coreflux": {
         "command": "python",
         "args": [
           "/ABSOLUTE/PATH/TO/server.py"
         ],
         "description": "Coreflux MQTT Broker Control",
         "icon": "🔄",
         "env": {
           "MQTT_BROKER": "localhost",
           "MQTT_PORT": "1883",
           "MQTT_USER": "",
           "MQTT_PASSWORD": ""
         }
       }
     }
   }
   

3. 重启 Claude Desktop

替代方法：使用 CLI

如果您直接运行服务器：

mcp server add coreflux --command python --args "/ABSOLUTE/PATH/TO/server.py"

环境变量

变量	描述	默认值
MQTT_BROKER	MQTT 代理地址	localhost
MQTT_PORT	MQTT 代理端口	1883
MQTT_USER	MQTT 用户名	-
MQTT_PASSWORD	MQTT 密码	-
MQTT_USE_TLS	为 MQTT 连接启用 TLS	false
MQTT_CA_CERT	CA 证书文件路径	-
MQTT_CLIENT_CERT	客户端证书文件路径	-
MQTT_CLIENT_KEY	客户端密钥文件路径	-

可用工具

该服务器为常见的 Coreflux 命令提供工具：

• add_rule: 添加新的权限规则
• remove_rule: 移除权限规则
• add_route: 添加新的路由连接
• remove_route: 移除路由连接
• add_model: 添加新的模型结构
• remove_model: 移除模型结构
• add_action: 添加新的操作事件/函数
• remove_action: 移除操作事件/函数
• run_action: 运行操作事件/函数
• remove_all_models: 移除所有模型
• remove_all_actions: 移除所有操作
• remove_all_routes: 移除所有路由
• list_discovered_actions: 列出所有已发现的 Coreflux 操作

LOT 语言资源

该服务器包含有关 LOT 语言的文档：

• lot://documentation/models: LOT 模型指南
• lot://documentation/rules: LOT 规则指南
• lot://documentation/actions: LOT 操作指南

调试和故障排除

如果您遇到问题：

1. 验证环境变量中的 MQTT 代理凭据
2. 确保可以访问代理
3. 检查 Claude Desktop 日志：

   # 检查 Claude 的日志以查找错误 (macOS/Linux)
   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   

4. 在调试模式下运行服务器：

   # 使用调试日志直接执行
   python server.py --debug
   

参考

• MCP 服务器开发者快速入门
• MCP 官方文档