Coreflux MCP Server

Coreflux MQTT MCP サーバー

これは、Coreflux MQTT ブローカーに接続し、Coreflux および MQTT アクションを Claude やその他の MCP 互換 AI アシスタントのツールとして使用できるようにするモデル コンテキスト プロトコル (MCP) サーバーです。

特徴

• Coreflux MQTTブローカーに接続する
• すべてのCorefluxコマンド（モデル、アクション、ルール、ルート）用のツールを提供します
• 利用可能なアクションを検出して一覧表示します
• LOT言語ドキュメントをリソースとして含む
• シームレスなClaude統合を実現する公式MCP SDKで構築
• 構成用のスタンドアロンセットアップアシスタント

セットアップアシスタント

サーバーには、メインサーバーとは別に実行できるスタンドアロンのセットアップアシスタントが含まれています。セットアップアシスタントは、以下の場合に実行してください。

• 初期設定（.envファイル）を作成する必要があります
• 既存の設定を更新したい
• 接続に問題が発生しているため、再設定が必要です

セットアップ アシスタントを実行するには:

セットアップ アシスタントは次のことに役立ちます。

• 設定に合わせて.envファイルを作成または更新します
• MQTTブローカーの設定（ホスト、ポート、資格情報）を構成する
• 必要に応じてTLS構成を設定する
• ログオプションを構成する

設定が完了したら、サーバーを通常どおり実行できます。

クロードを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 Broker Control", "icon": "🔄", "env": {} } } }
3. Claudeデスクトップを再起動します

コマンドライン引数

サーバーは以下のコマンドライン引数を受け入れます。これらの設定は、セットアップアシスタントを使用して.envファイルから設定することもできます。

利用可能なツール

サーバーは、一般的な 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. セットアップ アシスタントを実行して、構成を確認または更新します。
   python setup_assistant.py
4. Claude Desktop のログを確認します。
   # Check Claude's logs for errors (macOS/Linux) tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows PowerShell Get-Content -Path "$env:USERPROFILE\AppData\Roaming\Claude\Logs\mcp*.log" -Tail 20 -Wait
5. デバッグ ログ付きでサーバーを実行します。
   # Direct execution with debug logging python server.py --mqtt-host localhost --mqtt-port 1883 --log-level DEBUG

参考文献

• サーバー開発者向け MCP クイックスタート
• MCP公式ドキュメント