Corefluxmcpserver

🚀 核心通量MQTT MCP服務器

核心通量MQTT MCP服務器是一個模型上下文協議（MCP）服務器，它能夠連接到Coreflux MQTT代理，為Claude和其他與MCP兼容的AI助手提供Coreflux和MQTT操作，有效解決了AI助手與Coreflux及MQTT交互的問題，為相關應用提供了便捷的操作途徑。

✨ 主要特性

• 🔌 連接到Coreflux MQTT代理，搭建穩定的數據傳輸通道。
• 🛠️ 提供所有Coreflux命令（模型、動作、規則、路由）的工具，滿足多樣化的操作需求。
• 🔍 發現並列出可用的動作，方便用戶快速瞭解和使用。
• 📚 包含LOT語言文檔作為資源，助力開發人員進行擴展和集成。
• 🤝 使用官方MCP SDK構建，與Claude無縫集成，實現高效協作。
• ⚙️ 獨立設置助手進行配置，靈活滿足不同場景的配置需求。

📦 安裝指南

設置助手

服務器包含一個獨立的設置助手，可以單獨運行。當遇到以下情況時可使用：

• 需要創建初始配置（.env文件）。
• 更新現有配置。
• 經歷連接問題需要重新配置時。

運行設置助手的命令如下：

python setup_assistant.py

設置助手能幫助您完成以下配置：

• 創建或更新.env文件中的配置。
• 配置MQTT代理設置（主機、端口、憑據）。
• 設置TLS配置（如果需要）。
• 配置日誌選項。

完成配置後，即可正常運行服務器。

💻 使用示例

將Claude連接到MCP服務器

使用Claude Desktop Config

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 Desktop。

命令行參數

服務器接受以下命令行參數，這些設置也可以通過設置助手配置到.env文件中：

通過MCP協議連接Claude

基礎用法

1. 安裝依賴項：
   • 確保安裝了Python及其相關庫（如python-mqtt）。
2. 配置服務器：
   • 使用設置助手或手動編輯.env文件進行配置。
3. 啟動服務器：

python server.py

4. 在Claude中使用：
   • 配置Claude以連接到MCP服務器，並指定要使用的模型和動作。

📚 詳細文檔

教程與文檔

快速入門

1. 安裝並配置MCP服務器。
2. 設置CLAude以使用MCP協議。
3. 開始開發和部署自定義模型或服務。

詳細指南

• 開發者文檔：詳細說明如何擴展和定製MCP服務器，以及如何與各種工具和服務集成。
• 用戶指南：指導最終用戶如何配置和使用MCP服務器。

參考資料

• MCP協議快速入門（英文）
• MCP官方文檔