MATLAB MCP Core Server

公式

MathWorks®の公式MATLAB MCP Serverを使用して、AIアプリケーションでMATLAB®を実行します。

MATLAB Core MCPで何ができますか?

  • Run MATLAB code — AIアシスタントにMATLABコードスニペットやスクリプトを実行させ、evaluate_matlab_codeまたはrun_matlab_fileを使用して出力を返してもらいます。
  • Analyze code quality — アシスタントにMATLABスクリプトの静的解析を実行させ、check_matlab_codeを使用してスタイルの問題、潜在的なエラー、ベストプラクティス違反を特定してもらいます。
  • Run unit tests — アシスタントにMATLABテストファイルを実行させ、run_matlab_test_fileを使用して包括的なテスト結果を取得します。
  • Check installed toolboxesdetect_matlab_toolboxesを介して、インストールされているMATLABツールボックスとバージョン番号に関する情報をリクエストします。
  • Access coding guidelines — アシスタントにmatlab_coding_guidelinesおよびplain_text_live_code_guidelinesリソースからMATLABコーディング標準とライブスクリプトの書式ルールを参照してもらいます。

ドキュメント

MATLAB MCP Server

英語 • スペイン語日本語韓国語簡体字中国語

MathWorks® の公式 MATLAB MCP Server を使用して、AI アプリケーションで MATLAB® を実行します。MATLAB MCP Server を使用すると、AI アプリケーションで次のことが可能になります:

  • MATLAB の起動と終了。
  • MATLAB コードの記述と実行。
  • MATLAB コードのスタイルと正確性の評価。

エージェントが MATLAB と Simulink を使用するのを支援するには、MATLAB Agentic Toolkit (GitHub)Simulink Agentic Toolkit (GitHub) のスキルを使用できます。これらのツールキットは、この MCP サーバーをインストールすることもできます。

目次

セットアップ

  1. MATLAB (MathWorks) R2021a 以降をインストールし、システムの PATH に追加します。

  2. このサーバーは、Model Context Protocol を使用する任意の AI アプリケーションをサポートします。Claude Desktop 用に MATLAB MCP Server をセットアップするには、Claude Desktop の手順にスキップしてください。他のアプリケーション用にサーバーをセットアップするには、次の手順に従ってください:

    • Windows または Linux の場合、最新リリースをダウンロード します。(または、ソースからビルドすることもできます: Go をインストールし、go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest を使用してバイナリをビルドします)。

    • macOS の場合、まずターミナルで次のコマンドを実行して最新リリースをダウンロードします:

      • Apple シリコンプロセッサの場合、次を実行します:
        curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64
        
      • Intel プロセッサの場合、次を実行します:
        curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64
        

      次に、ダウンロードしたバイナリに実行権限を付与して、MATLAB MCP Server を実行できるようにします:

      chmod +x ~/Downloads/matlab-mcp-server
      
  3. MATLAB MCP Server を AI アプリケーションに追加します。MCP サーバーの追加方法については、AI アプリケーションのドキュメントを参照してください。Claude Code®、Claude Desktop®、Visual Studio® Code の GitHub Copilot の使用例については、以下を参照してください。オプションの 引数 を指定してサーバーをカスタマイズできることに注意してください。

Claude Code

ターミナルで次のコマンドを実行し、セットアップで取得したサーバーバイナリへのフルパスを挿入することを忘れないでください:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary

オプションの 引数 を指定してサーバーをカスタマイズできます。Claude Code のオプションとサーバー引数の間の -- セパレータに注意してください:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

Claude Code で MCP サーバーを追加する方法の詳細については、ローカル stdio サーバーの追加 (Claude Code) を参照してください。後でサーバーを削除するには、次を実行します:

claude mcp remove matlab

Claude Desktop

MATLAB MCP Server バンドルを使用して、Claude Desktop に MATLAB MCP Server をインストールします。

  1. Claude Desktop に Filesystem 拡張機能をインストールして、Claude がシステム上のファイルを読み書きできるようにします。Claude Desktop で、設定 > 拡張機能 > 拡張機能を参照 をクリックします。Anthropic が開発した Filesystem 拡張機能を検索し、インストール をクリックします。MCP サーバーがアクセスできるようにするフォルダーを指定し、無効 ボタンを切り替えて 有効 にして Filesystem 拡張機能を有効にします。

  2. 最新リリース ページから MATLAB MCP Server バンドル matlab-mcp-server.mcpb をダウンロードします。

  3. MATLAB MCP Server バンドルをデスクトップ拡張機能としてインストールするには、ダウンロードした matlab-mcp-server.mcpb ファイルをダブルクリックし、Claude Desktop で インストール をクリックします。(または、Claude で ファイルメニュー > 設定 > 拡張機能 > 詳細設定 > 拡張機能のインストール に移動し、matlab-mcp-server.mcpb ファイルを選択します。インストール をクリックします)。

MATLAB MCP Server の動作をカスタマイズするには、設定 > 拡張機能 > 構成 に移動し、サーバーの 引数 を変更できます。

Visual Studio Code の GitHub Copilot

VS Code ワークスペースで、.vscode/mcp.json という名前のファイルを作成します。次の JSON を挿入し、セットアップで取得したサーバーバイナリへのフルパスと、任意の 引数 を指定することを忘れないでください。次に、ファイルを保存します。(Windows では、パスにエスケープ文字として追加のスラッシュが必要になることに注意してください)。

{
    "servers": {
        "matlab": {
            "type": "stdio",
            "command": "C:\\fullpath\\to\\matlab-mcp-server-windows-x64.exe",
            "args": []
        }
    }
}

VS Code で MCP サーバーを使用する方法の詳細については、VS Code で MCP サーバーを追加および管理する (VS Code) を参照してください。

Codex

ターミナルで次のコマンドを実行し、セットアップで取得したサーバーバイナリへのフルパスを挿入することを忘れないでください:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary

オプションの 引数 を指定してサーバーをカスタマイズできます。例:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

[!NOTE] Windows ユーザー: Codex は WINDIR 環境変数を転送しません。これは MATLAB と Simulink を実行するために必要です (#32 を参照)。

変数を追加するには、C:\Users\<username>\.codex\config.toml にある Codex 設定ファイルを開き、[mcp_servers.matlab] セクションに env_vars = ["WINDIR"] を追加します:

[mcp_servers.matlab]
command = 'C:\fullpath\to\matlab-mcp-server-windows-x64.exe'
args = []
env_vars = ["WINDIR"]

引数

次のいずれかの方法で引数を指定して、サーバーの動作をカスタマイズします:

  • AI アプリケーションの構成設定 (通常は .json ファイル) に引数を挿入します。
  • サーバーを起動するときに、コマンドラインインターフェイス (CLI) フラグとして引数を入力します。
  • CLI またはアプリケーションの構成設定で指定された環境変数を使用します。CLI フラグから環境変数名を導出するには、プレフィックス MW_MCP_SERVER_ を追加し、大文字に変換し、ハイフン (-) をアンダースコア (_) に置き換えます。たとえば、引数 --matlab-root は環境変数 MW_MCP_SERVER_MATLAB_ROOT になります。両方を使用する場合、CLI フラグは環境変数よりも優先されます。
引数説明
helpすべての引数のヘルプ情報を表示します。--help
versionMATLAB MCP Server のバージョンを表示します。--version
matlab-root起動する MATLAB を指定するフルパス。パスに /bin を含めないでください。デフォルトでは、サーバーはシステムの PATH で最初の MATLAB を見つけようとします。Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a

Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a

環境変数として: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a
initialize-matlab-on-startupサーバーを起動したらすぐに MATLAB を初期化するには、この引数を true に設定します。デフォルトでは、MATLAB は最初のツールが呼び出されたときにのみ起動します。--initialize-matlab-on-startup=true
initial-working-folderMATLAB が起動するフォルダーを指定します。値を指定しない場合、MATLAB は AI アプリケーションの最初の ルート (MCP) のパスで起動します。ルートを定義していない場合、MATLAB は次の場所で起動します:
  • Linux: /home/username
  • Windows: C:\Users\username\Documents
  • Mac: /Users/username/Documents
Windows: --initial-working-folder=C:\\Users\\username\\MyProject

Linux/macOS: --initial-working-folder=/Users/username/MyProject
matlab-display-modeMATLAB デスクトップを表示するかどうかを指定します。desktop モード (デフォルト) を使用して MATLAB デスクトップを表示します。nodesktop モードを使用して、MATLAB デスクトップなしで AI アプリケーションからのみ MATLAB を使用します。nodesktop モードでは、グラフィカルインターフェイスを必要とするコマンド (editopenopen_systemuifigureappdesigner など) がデスクトップに MATLAB ウィンドウを開くことに注意してください。--matlab-display-mode=nodesktop
matlab-session-modeMCP サーバーが新しい MATLAB を起動するか、既存の MATLAB セッションに接続するかを指定します (MATLAB R2023a 以降でサポート)。デフォルトは auto モードです。

new モード: MCP サーバーは新しい MATLAB セッションを起動します。

auto モード (デフォルト): サーバーは既存の MATLAB セッションへの接続を試みます。このセッションは、以下の手順を使用して existing モード用に構成しておく必要があります。サーバーが既存の MATLAB セッションを見つけられない場合、新しいセッションを起動します。

existing モード: サーバーは既存の MATLAB セッションへの接続を試みます。このモードを引数 matlab-rootinitial-working-folder、または matlab-display-mode と組み合わせて使用しないでください。このモードを使用するには、MATLAB セッションを事前に次の手順で構成しておく必要があります:

  1. existing モードを初めて使用する場合は、./matlab-mcp-server --setup-matlab を実行します。

    このコマンドは、MATLAB に MATLAB MCP Server Toolbox という名前のアドオンをインストールします。この表の他の引数でコマンドをカスタマイズできます。たとえば、ツールボックスのインストールに使用する MATLAB を指定するには、./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a を使用できます。

    Claude Desktop の場合、./matlab-mcp-server --setup-matlab を実行する前に、セットアップ の手順を使用して MATLAB MCP Server バイナリをダウンロードする必要があります。

  2. 実行中の MATLAB セッションのコマンドウィンドウで、shareMATLABSession() を実行します。サーバーを --matlab-session-mode=existing または --matlab-session-mode=auto で起動すると、MCP サーバーはこの MATLAB に接続します。複数の MATLAB セッションを実行している場合、サーバーはコマンド shareMATLABSession() を最後に実行した MATLAB セッションに接続します。

    shareMATLABSession() を手動で実行する代わりに、コマンドを MATLAB スタートアップスクリプト (MathWorks) に追加できます。
--matlab-session-mode=existing
extension-fileカスタム MCP ツールを使用するには、ツールを定義する JSON ファイルへのパスを指定します。複数の拡張ファイルを使用することもできます。カスタムツールの使用の詳細については、MATLAB MCP Server でカスタムツールを使用する を参照してください。

Windows: --extension-file=C:\\Users\\name\\my-tools.json

Linux/macOS: --extension-file=/path/to/my-tools.json

複数の拡張ファイルの使用:

Windows:--extension-file=C:\\path\\to\\tools-1.json --extension-file=C:\\path\\to\\tools-2.json

Linux/macOS:--extension-file=/path/to/tools1.json --extension-file=/path/to/tools2.json

環境変数の使用:

Windows: MW_MCP_SERVER_EXTENSION_FILE=C:\Users\name\tools1.json;C:\Users\name\tools2.json

Linux/macOS: MW_MCP_SERVER_EXTENSION_FILE=/path/to/tools1.json:/path/to/tools2.json
log-folderMCP サーバーがログファイルを保存するフォルダーを指定します。指定しない場合、サーバーはオペレーティングシステムのデフォルトの一時フォルダーを使用します。Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp

Linux/macOS: --log-folder=/tmp/my-logs
log-levelMCP サーバーのログレベル。有効な値は、冗長性の高い順に、debuginfowarnerror です。デフォルトは info です。--log-level=debug
disable-telemetry匿名化されたデータ収集を無効にするには、この引数を true に設定します。詳細については、データ収集 を参照してください。--disable-telemetry=true

ツール

  1. detect_matlab_toolboxes

    • インストールされている MATLAB とツールボックスに関する情報 (バージョン番号を含む) を返します。
  2. check_matlab_code

    • MATLABスクリプトに対して静的コード解析を実行します。コーディングスタイル、潜在的なエラー、非推奨関数、パフォーマンスの問題、ベストプラクティス違反に関する警告を返します。これは非破壊的な読み取り専用操作であり、スクリプトを実行せずにコード品質の問題を特定するのに役立ちます。
    • 入力:
      • script_path (string): 解析するMATLABスクリプトファイルへの絶対パス。有効な.mファイルである必要があります。解析中にファイルは変更されません。例: C:\Users\username\matlab\myFunction.m または /home/user/scripts/analysis.m
  3. evaluate_matlab_code

    • MATLABコードの文字列を評価し、出力を返します。
    • 入力:
      • code (string): 評価するMATLABコード。
      • project_path (string): プロジェクトディレクトリへの絶対パス。MATLABはこのディレクトリを現在の作業フォルダーとして設定します。例: C:\Users\username\matlab-project または /home/user/research
  4. run_matlab_file

    • MATLABスクリプトを実行し、出力を返します。スクリプトは有効な.m fileである必要があります。
    • 入力:
      • script_path (string): 実行するMATLABスクリプトファイルへの絶対パス。有効な.mファイルである必要があります。例: C:\Users\username\projects\analysis.m または /home/user/matlab/simulation.m
  5. run_matlab_test_file

    • MATLABテストスクリプトを実行し、包括的なテスト結果を返します。MATLABテストフレームワークの規約に従うMATLABユニットテストファイル専用に設計されています。
    • 入力:
      • script_path (string): MATLABテストスクリプトファイルへの絶対パス。MATLABユニットテストを含む有効な.mファイルである必要があります。例: C:\Users\username\tests\testMyFunction.m または /home/user/matlab/tests/test_analysis.m

リソース

MCPサーバーは、AIアプリケーションがMATLABコードを作成するのに役立つリソース (MCP)を提供します。このリソースの使用手順については、リソースの使用方法を説明するAIアプリケーションのドキュメントを参照してください。

  1. matlab_coding_guidelines

    • コードの可読性、保守性、コラボレーションを向上させるための包括的なMATLABコーディング標準を提供します。ガイドラインには、命名規則、フォーマット、コメント、パフォーマンス最適化、エラーハンドリングが含まれます。
    • URI: guidelines://coding
    • MIMEタイプ: text/markdown
    • ソース: MATLABコーディング標準 (GitHub)
  2. plain_text_live_code_guidelines

    • バージョン管理とAI支援開発に適した、プレーンテキストのLive Code .mファイル形式を使用してライブスクリプトを生成するためのルールとガイドラインを提供します。プレーンテキストのライブスクリプトを実行するにはMATLAB R2025a以降が必要であることに注意してください。詳細については、Live Codeファイル形式 (MathWorks)を参照してください。
    • URI: guidelines://plain-text-live-code
    • MIMEタイプ: text/markdown
    • ソース: プレーンテキストLive Code生成 (GitHub)

データ収集

MATLAB MCP Serverは、サーバーの使用状況に関する完全に匿名化された情報を収集し、MathWorksに送信する場合があります。このデータ収集はMathWorksの製品改善に役立ち、デフォルトで有効になっています。データ収集をオプトアウトするには、引数--disable-telemetrytrueに設定します。

セキュリティに関する考慮事項

MATLAB MCP Serverを使用する際は、すべてのツール呼び出しを実行する前に徹底的にレビューおよび検証する必要があります。重要な操作には常に人間が関与し、呼び出しが期待どおりに実行されると確信できる場合にのみ続行してください。詳細については、ユーザーインタラクションモデル (MCP)およびセキュリティに関する考慮事項 (MCP)を参照してください。

ライセンスと使用

ライセンスは、このGitHubリポジトリのLICENSE.mdファイルで確認できます。

MCPサーバーは、MathWorksソフトウェアライセンス契約に従ってMATLABでのみ使用が許可されており、複数のユーザーで共有することはできません。共有または集中管理されたサーバー使用のサポートが必要な場合は、MathWorksにお問い合わせください。

サポートへの連絡

MathWorksは、このリポジトリの使用とフィードバックの提供を推奨しています。テクニカルサポートのリクエストや機能拡張のリクエストを送信するには、GitHub issueを作成するか、MathWorksテクニカルサポートにお問い合わせください。


Copyright 2025-2026 The MathWorks, Inc.