Corefluxmcpserver

🚀 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 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ファイルに構成することもできます。

ClaudeをMCPプロトコルで接続する

1. 依存関係のインストール
   • Pythonと関連するライブラリ（例：python-mqtt）がインストールされていることを確認してください。
2. サーバの設定
   • 設定アシスタントを使用するか、.envファイルを手動で編集して設定します。
3. サーバの起動

   python server.py
   

4. Claudeでの使用
   • Claudeを設定してMCPサーバに接続し、使用するモデルとアクションを指定します。

📚 ドキュメント

クイックスタート

1. MCPサーバのインストールと設定
2. ClaudeをMCPプロトコルで使用するように設定
3. カスタムモデルまたはサービスの開発とデプロイを開始

詳細ガイド

• 開発者ドキュメント：MCPサーバの拡張とカスタマイズ方法、および各種ツールやサービスとの統合方法を詳細に説明しています。
• ユーザーガイド：MCPサーバの設定と使用方法をエンドユーザーにガイドします。

参考資料

• MCPプロトコルクイックスタート（英語）
• MCP公式ドキュメント