Coreflux MQTT MCP Server

🚀 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クイックスタートガイド（サーバー開発者向け）