MeshLab-mcp

MeshLab-MCP

pymeshlab を使用したメッシュ操作のために、FastAPI（HTTP）とカスタム TCP（JSON）バックエンドを利用する、MeshLab 向けの最小限で拡張可能な Model Context Protocol（MCP）ブリッジです。

---

機能

• FastAPI を使用した、MCP クライアント（Web UI、オーケストレーター）向けの HTTP API
• MeshLab プロセス（pymeshlab を使用）と通信する TCP（JSON）バックエンド
• 拡張可能：新しいメッシュツールやプロトコルコマンドを簡単に追加できます

---

プロジェクト構成

MeshLab-mcp/
├── meshlab_tcp_server.py   # TCP server wrapping pymeshlab
├── meshlab_tcp_client.py   # TCP client for server communication
├── meshlab_mcp.py          # Core MCP protocol logic (extensible)
├── mcp_server.py           # FastAPI HTTP server (entrypoint)
├── mcp_client.py           # HTTP client for testing
├── requirements.txt
└── README.md

---

セットアップ手順

1. リポジトリをクローンし、ディレクトリに cd で移動します。

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

3. Python Scripts ディレクトリを PATH に追加します（まだ追加していない場合）：

   • 例：C:\Users\<your-username>\AppData\Roaming\Python\Python313\Scripts\
   • PATH を変更した後、ターミナルを再起動します。

4. MeshLab TCP サーバーを起動します（ターミナルで）：

   python meshlab_tcp_server.py
   

5. HTTP MCP サーバーを起動します（別のターミナルで）：

   python -m uvicorn mcp_server:app --reload
   

   uvicorn が認識されない場合は、上記のようにフルパスを使用するか、python -m uvicorn ... 形式で実行します。

6. HTTP クライアントでテストします（任意）：

   python mcp_client.py
   

   次のような出力が表示されます：

   {'mesh_loaded': False, 'current_mesh_name': None}
   

---

MCP クライアント設定例（MeshLab との統合）

MeshLab（またはオーケストレーター）をこの MCP サーバーに接続するには、次のような設定を使用します：

{
  "mcpServers": {
    "meshlab": {
      "command": "uvx",
      "args": [
        "meshlab-mcp"
      ],
      "host": "127.0.0.1",
      "port": 8000
    }
  }
}

• command：MCP HTTP サーバーを起動するコマンドです（例：uvx meshlab-mcp または python -m uvicorn mcp_server:app --reload）。
• host/port：HTTP API に接続できる場所です。

---

仕組み

• MCP クライアント（Web UI、オーケストレーター）は、FastAPI サーバーに HTTP リクエストを送信します。
• FastAPI サーバーは、これらのリクエストを MeshLab TCP サーバー（pymeshlab を使用してメッシュ操作を実行）に中継します。
• TCP サーバーは JSON 形式で結果を返します。

---

拡張

• meshlab_tcp_server.py に新しいメッシュツール／コマンドを追加し、プロトコルで公開します。
• 対応するメソッドを meshlab_tcp_client.py に追加し、新しい HTTP エンドポイントを mcp_server.py に追加します。

---

トラブルシューティング

• uvicorn が認識されない場合は、Python Scripts ディレクトリが PATH に含まれていることを確認するか、python -m uvicorn ... を使用してください。
• HTTP サーバーを起動する前に、必ず TCP サーバーを起動してください。
• メッシュ操作を行う場合は、メッシュファイルが作業ディレクトリにあることを確認してください。

---

次のステップ

• 新しいメッシュツールとプロトコルコマンドの開発を始めましょう！
• MeshLab の GUI やその他のツールとの高度な統合については、MeshLab のドキュメントと MCP の仕様を参照してください。

---

ご質問や新機能の追加をご希望の場合は、お気軽にお知らせください！