Coreflux MQTT MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

Coreflux MQTT MCP Server 是一个连接 Coreflux MQTT 代理的 MCP 服务器，为 AI 助手提供 Coreflux 和 MQTT 操作的工具支持。

核心功能

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

适用场景

• 需要将 Coreflux MQTT 代理与 AI 助手集成的场景
• 需要管理和操作 Coreflux 模型、动作、规则和路由的场景
• 需要生成 LOT 代码的场景

工具列表

• 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. 如何验证 MQTT 代理凭证？
2. 在 Claude 配置中检查 MQTT 代理凭证
3. 如何确保代理可访问？
4. 确保代理运行并可从服务器访问
5. 如何更新配置？
6. 运行设置助手：python setup_assistant.py
7. 如何查看日志？
8. macOS/Linux: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
9. Windows: Get-Content -Path "$env:USERPROFILE\AppData\Roaming\Claude\Logs\mcp*.log" -Tail 20 -Wait
10. 如何启用调试日志？
11. 运行服务器时添加 --log-level DEBUG 参数

使用教程

使用依赖

• Python 环境
• Coreflux MQTT 代理

安装教程

1. 克隆或下载服务器代码
2. 运行设置助手进行配置：
   bash
python setup_assistant.py
3. 配置完成后，运行服务器：
   bash
python server.py

调试方式

1. 运行服务器时启用调试日志：
   bash
python server.py --log-level DEBUG
2. 检查 Claude 日志：
3. macOS/Linux: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
4. Windows: Get-Content -Path "$env:USERPROFILE\AppData\Roaming\Claude\Logs\mcp*.log" -Tail 20 -Wait
5. 验证 MQTT 连接参数是否正确