MATLAB MCP サーバー

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

セットアップ要件

• Python 3.11 (Python 3.13 および 3.12 は現在 MATLAB エンジンではサポートされていません)

• MATLAB R2024a（または互換バージョン）

• UVパッケージマネージャー

Related MCP server: Fused MCP Agents

インストール

1. 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]"

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

ディレクトリ構造

• matlab_server.py : メインのMCPサーバーの実装

• matlab_scripts/ : すべてのMATLABスクリプトと関数が保存されるディレクトリ（自動的に作成されます）

• pyproject.toml : Python プロジェクト構成

• .python-version : uvのPythonバージョンを指定します

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

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

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

2. 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インストールを指していることを確認します

• 絶対パスを使用する（相対パスではない）

特徴

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

1. create_matlab_script : 新しいMATLABスクリプトファイルを作成する

   • スクリプトはmatlab_scriptsディレクトリに保存されます

   • ファイル名は有効なMATLAB識別子である必要があります

2. create_matlab_function : 新しいMATLAB関数ファイルを作成する

   • 関数はmatlab_scriptsディレクトリに保存されます

   • 有効な関数定義を含める必要があります

3. execute_matlab_script : MATLAB スクリプトを実行して結果を取得する

   • 出力テキスト、生成された図、ワークスペース変数を返します

   • スクリプトに引数を渡すことができる

4. 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デスクトップの設定で設定するか、直接実行するときに設定

トラブルシューティング

1. MATLABエンジンのインストールに失敗する

   • MATLAB_PATHが正しいことを確認する

   • エンジンを手動でインストールしてみます:

     cd $MATLAB_PATH/extern/engines/python
     python setup.py install

2. Pythonバージョンの問題

   • Python 3.11を使用していることを確認してください

   • 確認: python --version

   • 必要に応じてuv python pin 3.11使用してください

3. スクリプト実行エラー

   • matlab_scriptsディレクトリが存在することを確認する

   • スクリプトの構文が有効であることを確認する

   • MATLAB出力でエラーメッセージを探す

アップデートとメンテナンス

• MATLABのインストールを最新の状態に保つ

• 必要に応じてPythonパッケージを更新します: uv pip install --upgrade mcp[cli]

• Python をアップデートする際に MATLAB エンジンの互換性を確認する