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出力でエラーメッセージを探す
アップデートとメンテナンス
- MATLABのインストールを最新の状態に保つ
- 必要に応じてPythonパッケージを更新します:
uv pip install --upgrade mcp[cli]
- Python をアップデートする際に MATLAB エンジンの互換性を確認する