Matlabmcp

🚀 MATLAB MCP 統合

このプロジェクトは、MATLAB 用に実装された Model Context Protocol (MCP) サーバーです。MCP クライアント（LLM エージェントや Claude Desktop など）が、MATLAB エンジン API for Python を通じて、共有された MATLAB セッションと相互作用できるようにします。

✨ 主な機能

• MATLAB コードの実行：runMatlabCode ツールを使用して、任意の MATLAB コード断片を実行できます。
• 変数の取得：getVariable ツールを使用して、MATLAB ワークスペース内の変数の値を取得できます。
• 構造化通信：ツールは結果とエラーを構造化された JSON 形式で返すため、クライアントでのプログラミング処理が容易です。
• 非同期実行：asyncio.to_thread を使用して MATLAB エンジンの呼び出しを非同期で実行するため、サーバーがブロックされることがありません。
• 標準ロギング：Python の標準 logging モジュールを使用して、stderr に出力されるため、クライアントのログで確認できます。
• 共有セッション：既存の共有 MATLAB セッションに接続できます。

今後の予定：

• setVariable ツールを追加して、MATLAB ワークスペースにデータを書き込めるようにする。
• runScript ツールを追加して、.m ファイルを直接実行できるようにする。
• ワークスペース管理ツール（clearWorkspace、getWorkspaceVariables など）を追加する。
• matlab_to_python 補助関数を拡張して、より複雑なデータ型（構造体、セル配列、オブジェクト）をサポートする。
• Simulink モデルとの相互作用をサポートする。

📦 インストール

1. リポジトリのクローン

git clone https://github.com/jigarbhoye04/MatlabMCP.git
cd MatlabMCP

2. Python 仮想環境の設定（推奨）

# まだインストールされていない場合は、uv をインストールしてください：https://github.com/astral-sh/uv
uv init
uv venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate

3. 依存関係のインストール

uv pip sync

4. MATLAB と MATLAB エンジン API for Python の設定

MATLAB がインストールされ、MATLAB エンジン API for Python が正しく構成されていることを確認してください。詳細は MATLAB ドキュメント を参照してください。

5. MATLAB エンジンの共有

MATLAB コマンドウィンドウで以下のコマンドを実行して、MATLAB エンジンを共有します。

matlab.engine.shareEngine

matlab.engine.isEngineShared を実行して、エンジンが共有されていることを確認できます（true が返されるはずです）。

📚 ドキュメント

クラウドデスクトップとの統合

このサーバーを Claude Desktop と統合する手順は以下の通りです。

1. プロジェクト内でこのリポジトリをクローンします。
2. config.json ファイルに必要な設定情報（API キーやエンドポイントなど）を記入します。
3. サーバーを起動し、Claude プラットフォームに接続します。

開発に関する詳細

このサーバーの機能、使用方法、開発時の注意事項に関する詳細なドキュメントは、こちら を参照してください。

🤝 貢献

皆様からの貢献を歓迎します！何か提案や改善点があれば、いつでも Issue や Pull Request を送信してください。一緒にこのプロジェクトを良くしましょう！