MATLAB MCP サーバー

このモデルコンテキストプロトコル (MCP) サーバーは MATLAB との統合を提供し、Claude またはその他の MCP クライアントを通じて MATLAB スクリプトと関数を作成および実行できるようにします。

セットアップ要件

Python 3.11 (Python 3.13 および 3.12 は現在 MATLAB エンジンではサポートされていません)
MATLAB R2024a（または互換バージョン）
UVパッケージマネージャー

インストール

Python 環境を作成して設定します。

# Pin Python version uv python pin 3.11 # Create virtual environment uv venv # Activate virtual environment source .venv/bin/activate # Install MCP uv add "mcp[cli]"

MATLAB エンジンをインストールします。MATLAB エンジンは、 MATLAB_PATH環境変数で指定された MATLAB インストールを使用して、サーバーの初回実行時に自動的にインストールされます。

ディレクトリ構造

matlab_server.py : メインのMCPサーバーの実装
matlab_scripts/ : すべてのMATLABスクリプトと関数が保存されるディレクトリ（自動的に作成されます）
pyproject.toml : Python プロジェクト構成
.python-version : uvのPythonバージョンを指定します

クロードデスクトップ統合

Claude デスクトップ構成を開きます。

# On macOS code ~/Library/Application\ Support/Claude/claude_desktop_config.json

MATLAB サーバー構成を追加します。

{ "mcpServers": { "matlab": { "command": "uv", "args": [ "--directory", "/absolute/path/to/matlab-mcp", "run", "matlab_server.py" ], "env": { "MATLAB_PATH": "/Applications/MATLAB_R2024a.app" } } } }

必ず次の点に注意してください:

/absolute/path/to/matlab-mcpプロジェクトディレクトリへの実際のパスに置き換えます。
MATLAB_PATHがMATLABインストールを指していることを確認します
絶対パスを使用する（相対パスではない）

特徴

サーバーはいくつかのツールを提供します:

create_matlab_script : 新しいMATLABスクリプトファイルを作成する
- スクリプトはmatlab_scriptsディレクトリに保存されます
- ファイル名は有効なMATLAB識別子である必要があります
create_matlab_function : 新しいMATLAB関数ファイルを作成する
- 関数はmatlab_scriptsディレクトリに保存されます
- 有効な関数定義を含める必要があります
execute_matlab_script : MATLAB スクリプトを実行して結果を取得する
- 出力テキスト、生成された図、ワークスペース変数を返します
- スクリプトに引数を渡すことができる
call_matlab_function : 引数を指定してMATLAB関数を呼び出す
- 関数の出力と生成された数値を返します

テスト

MCP Inspector を使用してサーバーをテストできます。

# Make sure you're in your virtual environment source .venv/bin/activate # Run the inspector MATLAB_PATH=/Applications/MATLAB_R2024a.app mcp dev matlab_server.py

テストスクリプトの例:

t = 0:0.01:2*pi; y = sin(t); plot(t, y); title('Test Plot'); xlabel('Time'); ylabel('Amplitude');

スクリプトストレージ

すべてのMATLABスクリプトと関数はmatlab_scriptsディレクトリに保存されます。
このディレクトリはサーバーの起動時に自動的に作成されます
ファイル名は<script_name>.mまたは<function_name>.m
ディレクトリはmatlab_server.pyと同じ場所にあります

環境変数

MATLAB_PATH : MATLABインストールへのパス
- デフォルト: /Applications/MATLAB_R2024a.app
- Claudeデスクトップの設定で設定するか、直接実行するときに設定

トラブルシューティング

MATLABエンジンのインストールに失敗する
- MATLAB_PATHが正しいことを確認する
- エンジンを手動でインストールしてみます:
  cd $MATLAB_PATH/extern/engines/python python setup.py install
Pythonバージョンの問題
- Python 3.11を使用していることを確認してください
- 確認: python --version
- 必要に応じてuv python pin 3.11使用してください
スクリプト実行エラー
- matlab_scriptsディレクトリが存在することを確認する
- スクリプトの構文が有効であることを確認する
- MATLAB出力でエラーメッセージを探す