MATLAB

🚀 MATLAB MCP サーバー

この Model Context Protocol (MCP) サーバーは MATLAB との統合を提供し、Claude やその他の MCP クライアントを通じて MATLAB スクリプトや関数の作成と実行を可能にします。

🚀 クイックスタート

この MCP サーバーを使用することで、Claude やその他の MCP クライアントから MATLAB スクリプトや関数を操作できます。以下に詳細なセットアップと使用方法を説明します。

✨ 主な機能

このサーバーは以下のツールを提供します：

1. create_matlab_script：新しい MATLAB スクリプトファイルを作成します。
   • スクリプトは matlab_scripts ディレクトリに保存されます。
   • ファイル名は有効な MATLAB 識別子である必要があります。
2. create_matlab_function：新しい MATLAB 関数ファイルを作成します。
   • 関数は matlab_scripts ディレクトリに保存されます。
   • ファイル名は MATLAB 関数の命名規則に従う必要があります。
3. execute_matlab_script：MATLAB スクリプトを実行します。
   • スクリプトのパスとパラメータを指定してスクリプトを実行します。
4. call_matlab_function：MATLAB 関数を呼び出します。
   • 関数名と入力パラメータを指定して関数を呼び出します。

📦 インストール

インストール要件

• Python 3.11（現在、Python 3.13 と 3.12 はサポートされていません）
• MATLAB R2024a（または互換性のあるバージョン）
• uv パッケージマネージャー

インストール手順

1. Python 環境の作成と設定：

# Python バージョンを固定
uv python pin 3.11

# 仮想環境を作成
uv venv

# 仮想環境をアクティブ化
source .venv/bin/activate

# MCP をインストール
uv add "mcp[cli]"

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

📚 ドキュメント

ディレクトリ構造

• matlab_server.py：MCP サーバーの主要な実装ファイル
• matlab_scripts/：すべての MATLAB スクリプトと関数はこのディレクトリに保存されます（自動的に作成されます）
• pyproject.toml：Python プロジェクトの設定ファイル
• .python-version：Python バージョンを指定するファイル

Claude デスクトップ統合

1. Claude デスクトップの設定を開きます：

# 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. MATLAB スクリプトファイル（例：test_script.m）を作成します：

function result = test_function(input)
    result = input + 1;
end

2. サーバー上でテストスクリプトを実行します：

uv run matlab_server.py --test

スクリプトの保存

• すべての MATLAB スクリプトと関数は matlab_scripts ディレクトリに保存されます。
• 各スクリプトまたは関数ファイルは一意の名前を持ち、MATLAB の命名規則に従う必要があります。

環境変数

• MATLAB_PATH：MATLAB インストールディレクトリの場所を指定します。デフォルトは /Applications/MATLAB_R2024a.app です。

トラブルシューティング

1. MATLAB エンジンのインストールが失敗した場合
   • MATLAB_PATH が正しいことを確認してください。
   • MATLAB が正しくインストールされ、実行権限があることを確認してください。
2. Python バージョンが互換性がない場合
   • Python バージョンが 3.11 であることを確認してください。
   • uv python version コマンドを使用して現在の Python バージョンを確認してください。
3. スクリプトまたは関数が実行できない場合
   • スクリプトまたは関数ファイルに構文エラーがないことを確認してください。
   • スクリプトまたは関数に実行権限があることを確認してください。

更新とメンテナンス

1. MATLAB と Python の最新バージョンを定期的に確認してください。
2. uv update コマンドを使用して MCP サーバーと関連する依存関係を更新してください。
3. 問題が発生した場合は、公式ドキュメントを参照するか、技術サポートに連絡してください。