Coreflux MQTT MCP 服务器

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

功能

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

设置助手

该服务器包括一个独立的设置助手，可以与主服务器分开运行。在以下情况下运行设置助手：

• 您需要创建初始配置（.env文件）
• 您想要更新现有配置
• 您遇到连接问题并需要重新配置

要运行设置助手：

python setup_assistant.py

设置助手帮助您：

• 创建或更新包含您的配置的.env文件
• 配置MQTT代理设置（主机、端口、凭证）
• 如有需要，设置TLS配置
• 配置日志选项

完成配置后，您可以正常运行服务器。

将Claude连接到MCP服务器

使用Claude桌面配置

1. 创建或编辑~/Library/Application Support/Claude/claude_desktop_config.json（macOS/Linux）或%USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json（Windows）
2. 添加以下配置（根据需要调整路径）：

   {
     "mcpServers": {
       "coreflux": {
         "command": "python",
         "args": [
           "/PATH/TO/server.py",
           "--mqtt-host", "localhost", 
           "--mqtt-port", "1883",
           "--mqtt-user", "root",
           "--mqtt-password", "coreflux",
           "--mqtt-client-id", "claude-coreflux-client"
         ],
         "description": "Coreflux MQTT Broker Control",
         "icon": "🔄",
         "env": {}
       }
     }
   }
   

3. 重启Claude桌面应用

命令行参数

服务器接受以下命令行参数。这些设置也可以通过使用设置助手的.env文件进行配置：

可用工具

服务器提供了常见的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动作
• request_lot_code: 根据自然语言提示生成LOT代码

调试和故障排除

如果您遇到问题：

1. 在Claude配置中验证您的MQTT代理凭据
2. 确保代理可访问
3. 运行设置助手以验证或更新您的配置：

   python setup_assistant.py
   

4. 检查Claude桌面日志：

   # 检查Claude的日志错误（macOS/Linux）
   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   # Windows PowerShell
   Get-Content -Path "$env:USERPROFILE\AppData\Roaming\Claude\Logs\mcp*.log" -Tail 20 -Wait
   

5. 使用调试日志运行服务器：

   # 直接执行并启用调试日志
   python server.py --mqtt-host localhost --mqtt-port 1883 --log-level DEBUG
   

参考资料

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