MATLAB MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

MATLAB MCP サーバー

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

セットアップ要件

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

インストール

  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]"
  1. 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
  1. 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 エンジンの互換性を確認する
-
security - not tested
F
license - not found
-
quality - not tested

Claude またはその他の MCP クライアントを通じてスクリプトと関数を作成および実行することにより、MATLAB との対話を可能にし、環境構成機能によるスクリプトの管理と実行結果の取得をサポートします。

  1. Setup Requirements
    1. Installation
      1. Directory Structure
        1. Claude Desktop Integration
          1. Features
            1. Testing
              1. Script Storage
                1. Environment Variables
                  1. Troubleshooting
                    1. Updates and Maintenance
                      ID: tf2154y420