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

基本能力

产品定位

Coreflux MCP Server 是一个用于连接 Coreflux MQTT 代理的 MCP 服务器，旨在为 AI 助手提供管理和控制 Coreflux 命令的工具。

核心功能

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

适用场景

• 通过 AI 助手管理和控制 Coreflux MQTT 代理
• 自动化执行 Coreflux 命令
• 开发和调试 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. 检查 Claude Desktop 日志
4. 使用调试日志运行服务器

使用教程

使用依赖

• Python 环境
• Coreflux MQTT 代理

安装教程

1. 创建或编辑配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS/Linux) 或 %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json (Windows)
2. 添加以下配置（根据路径调整）：
   json
{
"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 Desktop

调试方式

1. 检查 Claude 日志（macOS/Linux）：
   bash
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   Windows PowerShell：
   bash
Get-Content -Path "$env:USERPROFILE\AppData\Roaming\Claude\Logs\mcp*.log" -Tail 20 -Wait
2. 使用调试日志运行服务器：
   bash
python server.py --mqtt-host localhost --mqtt-port 1883 --debug