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 ディレクトリに保存されます。
   • 有効な関数定義を含む必要があります。

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 インストールを使用します。

💻 使用例

基本的な使用法

# Claude デスクトップの設定を開く
# macOS の場合
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

高度な使用法

{
    "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 のインストール場所を指していることを確認してください。
• 絶対パスを使用してください（相対パスは使用しないでください）。

テスト例

# 仮想環境にいることを確認
source .venv/bin/activate

# チェッカーを実行
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_server.py：MCP サーバーの主要な実装ファイル
• matlab_scripts/：すべての MATLAB スクリプトと関数が保存されるディレクトリ（自動作成）
• pyproject.toml：Python プロジェクトの設定ファイル
• .python-version：Python バージョンを指定するファイル

スクリプトの保存

• すべての MATLAB スクリプトと関数は matlab_scripts ディレクトリに保存されます。
• このディレクトリはサーバー起動時に自動的に作成されます。
• ファイル名は <script_name>.m または <function_name>.m です。
• スクリプトと関数の名前を明確にし、既存のファイルとの衝突を避けてください。

注意事項

• インストールが完了したら、すべてのパスが正しく設定されていることを確認してください。
• 問題が発生した場合は、ログ出力を確認して詳細を取得してください。