Coreflux MQTT MCP Server

🚀 Coreflux MQTT MCP 服務器

Coreflux MQTT MCP 服務器是一個模型上下文協議（MCP）服務器，它能連接到 Coreflux MQTT 代理，為 Claude 及其他與 MCP 兼容的 AI 助手提供 Coreflux 和 MQTT 操作，極大地提升了相關操作的便利性和效率。

✨ 主要特性

• 🔗 可連接到 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 代理控制",
         "icon": "🔄",
         "env": {}
       }
     }
   }
   

3. 重啟 Claude 桌面。

命令行參數

服務器接受以下命令行參數。這些設置也可以通過 setup_assistant.py 中的.env 文件進行配置：

可用工具

服務器支持以下命令：

基礎用法

# 啟動服務器
python server.py [--host HOST] [--port PORT]

高級用法

# 停止服務器
python server.py stop

# 重載配置
python server.py reload

📚 詳細文檔

調試和故障排除

驗證配置

確保設置助手正確配置了 MQTT 代理，並且所有憑據有效。

檢查日誌

默認情況下，服務器輸出到控制檯。要啟用文件日誌記錄，請修改配置文件中的 LOG_LEVEL 和 LOG_FILE 參數。

參考資料

• MCP 官方文檔
• MCP 快速入門指南（服務器開發人員）