MATLAB MCP Core Server

MATLAB MCP 伺服器

英文 • 西班牙文 • 日文 • 韓文 • 簡體中文

[!WARNING] 自 v0.11.0 起，MATLAB MCP Core Server 已更名為 MATLAB MCP Server。若要在此變更後使用最新版本的伺服器，您必須更新您的設定。

變更	所需動作
二進位檔名稱 新格式：matlab-mcp-server-<os>-<arch>[.exe] 範例：matlab-mcp-server-windows-x64.exe	在您的 AI 應用程式設定檔（通常是 .json 檔案）中更新二進位檔名稱。
工具箱 已更新並重新命名：MATLAB MCP Core Server Toolbox → MATLAB MCP Server Toolbox	執行 ./matlab-mcp-server --setup-matlab 安裝最新版本的工具箱。您需要此工具箱才能連線到現有的 MATLAB 工作階段。詳情請參閱引數章節中的 matlab-session-mode。
儲存庫網址 github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	無。GitHub 會自動重新導向。
MCP 套件組合 已更新並重新命名：matlab-mcp-core-server.mcpb → matlab-mcp-server.mcpb	如果您在 v0.11.0 之前使用 MATLAB MCP 套件組合在 Claude Desktop 中安裝 MCP 伺服器，請先解除安裝伺服器，然後從最新版本頁面下載新的 matlab-mcp-server.mcpb 套件組合，並用它來重新安裝伺服器。詳情請參閱 Claude Desktop 章節。
Go 模組 github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	如果您在 Go 專案中使用 MATLAB MCP Core Server 模組，請更新 go.mod 和您的匯入宣告中的模組名稱。

使用 MathWorks® 提供的官方 MATLAB MCP 伺服器，透過 AI 應用程式執行 MATLAB®。MATLAB MCP 伺服器可讓您的 AI 應用程式：

• 啟動和結束 MATLAB。
• 撰寫和執行 MATLAB 程式碼。
• 評估您的 MATLAB 程式碼的風格和正確性。

若要協助您的代理程式使用 MATLAB 和 Simulink，您可以使用來自 MATLAB Agentic Toolkit (GitHub) 和 Simulink Agentic Toolkit (GitHub) 的技能，它們也可以為您安裝此 MCP 伺服器。

目錄

• 設定
  • Claude Code
  • Claude Desktop
  • Visual Studio Code 中的 GitHub Copilot
  • Codex
• 引數
• 工具
• 資源
• 資料收集
• 安全性考量
• 授權與使用
• 聯絡支援

設定

1. 安裝 MATLAB (MathWorks) R2021a 或更新版本，並將其新增至系統 PATH。MATLAB MCP 伺服器支援過去五年內的 MATLAB 版本。

2. 此伺服器支援任何使用模型上下文協定的 AI 應用程式。若要為 Claude Desktop 設定 MATLAB MCP 伺服器，請跳至 Claude Desktop 的說明。若要為其他應用程式設定伺服器，請遵循以下說明：

   • 對於 Windows 或 Linux，下載最新版本。（或者，您可以從原始碼建置：安裝 Go 並使用 go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest 建置二進位檔）。

   • 對於 macOS，請先在您的終端機中執行以下命令來下載最新版本：

     • 對於 Apple silicon 處理器，請執行：

       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 伺服器：

     chmod +x ~/Downloads/matlab-mcp-server
     

3. 將 MATLAB MCP 伺服器新增至您的 AI 應用程式。您可以在 AI 應用程式的文件中找到新增 MCP 伺服器的說明。例如，關於使用 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 伺服器套件組合，在 Claude Desktop 中安裝 MATLAB MCP 伺服器。

1. 在 Claude Desktop 中安裝 Filesystem 擴充功能，以允許 Claude 讀取和寫入您系統上的檔案。在 Claude Desktop 中，按一下 Settings > Extensions > Browse extensions。搜尋由 Anthropic 開發的 Filesystem 擴充功能，然後按一下 Install。指定您要允許 MCP 伺服器存取的資料夾，然後將 Disabled 按鈕切換為 Enable 以啟用 Filesystem 擴充功能。

2. 從最新版本頁面下載 MATLAB MCP 伺服器套件組合 matlab-mcp-server.mcpb。

3. 若要將 MATLAB MCP 伺服器套件組合作為桌面擴充功能安裝，請按兩下下載的 matlab-mcp-server.mcpb 檔案，然後在 Claude Desktop 中按一下 Install。（或者，在 Claude 中導覽至 File menu > Settings > Extensions > Advanced Settings > Install Extension，然後選取 matlab-mcp-server.mcpb 檔案。按一下 Install）。

若要自訂 MATLAB MCP 伺服器的行為，請導覽至 Settings > Extensions > Configure，您可以在其中修改伺服器的引數。

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 不會轉發執行 MATLAB 和 Simulink 所需的 WINDIR 環境變數（請參閱 #32）。

若要新增該變數，請在 C:\Users\<username>\.codex\config.toml 開啟您的 Codex 設定檔，並將 env_vars = ["WINDIR"] 新增至 [mcp_servers.matlab] 區段：

[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 旗標和環境變數，CLI 旗標的優先順序高於環境變數。 | 引數 | 說明 | 範例 | | ------------- | ------------- | ------------- | | help | 顯示所有引數的說明資訊。 | --help | | version | 顯示 MATLAB 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-folder | 指定 MATLAB 啟動時的資料夾。若未指定值，MATLAB 會從您的 AI 應用程式第一個 Root (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-mode | 指定是否顯示 MATLAB 桌面。使用 desktop 模式（預設）可顯示 MATLAB 桌面。使用 nodesktop 模式可僅從您的 AI 應用程式使用 MATLAB，而不顯示 MATLAB 桌面。請注意，在 nodesktop 模式下，需要圖形介面的指令（例如 edit、open、open_system、uifigure 和 appdesigner）仍會在您的桌面上開啟 MATLAB 視窗。 | --matlab-display-mode=nodesktop | | matlab-session-mode | 指定 MCP 伺服器要啟動新的 MATLAB 還是連接到現有的 MATLAB 工作階段（支援 MATLAB R2023a 及更新版本）。預設為 auto 模式。
  
  new 模式： MCP 伺服器會啟動一個新的 MATLAB 工作階段。
  
  auto 模式（預設）： 伺服器會嘗試連接到現有的 MATLAB 工作階段，您必須使用以下說明為 existing 模式設定好該工作階段。如果伺服器找不到現有的 MATLAB 工作階段，則會啟動一個新的。
  
  existing 模式： 伺服器會嘗試連接到現有的 MATLAB 工作階段。使用此模式前，您必須先透過以下步驟設定好 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，您必須先使用 Setup 中的說明下載 MATLAB MCP Server 二進位檔，然後才能執行 ./matlab-mcp-server --setup-matlab。
     
     
  2. 在執行中的 MATLAB 工作階段命令視窗中，執行 shareMATLABSession()。當您以 --matlab-session-mode=existing 或 --matlab-session-mode=auto 啟動伺服器時，MCP 伺服器將會連接到此 MATLAB。如果您正在執行多個 MATLAB 工作階段，伺服器會連接到您最近執行過 shareMATLABSession() 指令的 MATLAB 工作階段。
     
     除了手動執行 shareMATLABSession() 之外，您也可以將該指令新增到您的 MATLAB Startup Script (MathWorks) 中。
  | --matlab-session-mode=existing | | extension-file | 若要使用自訂的 MCP 工具，請提供定義工具之 JSON 檔案的路徑。您也可以使用多個擴充功能檔案。有關使用自訂工具的詳細資訊，請參閱 Use Custom Tools with the 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-folder | 指定 MCP 伺服器儲存記錄檔的資料夾。若未指定，伺服器會使用您作業系統的預設暫存資料夾。 | Windows：--log-folder=C:\\Users\\name\\AppData\\Local\\Temp
  
  Linux/macOS：--log-folder=/tmp/my-logs | | log-level | MCP 伺服器的記錄層級。有效值依詳細程度遞減排列為 debug、info、warn 和 error。 | --log-level=debug | | disable-telemetry | 若要停用匿名資料收集，請將此引數設為 true。有關詳細資訊，請參閱 Data Collection。 | --disable-telemetry=true |

工具

1. detect_matlab_toolboxes

   • 傳回已安裝的 MATLAB 和工具箱的相關資訊，包括版本號碼。

2. check_matlab_code

   • 對 MATLAB 指令碼執行靜態程式碼分析。傳回有關編碼風格、潛在錯誤、已棄用函式、效能問題和最佳實踐違規的警告。這是一個非破壞性的唯讀操作，有助於在不執行指令碼的情況下識別程式碼品質問題。
   • 輸入：
     • script_path (字串)：要分析的 MATLAB 指令碼檔案的絕對路徑。必須是有效的 .m 檔案。分析期間不會修改該檔案。範例：C:\Users\username\matlab\myFunction.m 或 /home/user/scripts/analysis.m。

3. evaluate_matlab_code

   • 評估一段 MATLAB 程式碼字串並傳回輸出。
   • 輸入：
     • code (字串)：要評估的 MATLAB 程式碼。
     • project_path (字串)：您的專案目錄的絕對路徑。MATLAB 會將此目錄設定為目前的工作資料夾。範例：C:\Users\username\matlab-project 或 /home/user/research。

4. run_matlab_file

   • 執行 MATLAB 指令碼並傳回輸出。該指令碼必須是有效的 .m file。
   • 輸入：
     • script_path (字串)：要執行的 MATLAB 指令碼檔案的絕對路徑。必須是有效的 .m 檔案。範例：C:\Users\username\projects\analysis.m 或 /home/user/matlab/simulation.m。

5. run_matlab_test_file

   • 執行 MATLAB 測試指令碼並傳回全面的測試結果。專為遵循 MATLAB 測試框架慣例的 MATLAB 單元測試檔案而設計。
   • 輸入：
     • script_path (字串)：MATLAB 測試指令碼檔案的絕對路徑。必須是包含 MATLAB 單元測試的有效 .m 檔案。範例：C:\Users\username\tests\testMyFunction.m 或 /home/user/matlab/tests/test_analysis.m。

資源

MCP 伺服器提供 Resources (MCP) 來協助您的 AI 應用程式撰寫 MATLAB 程式碼。若要查看使用此資源的說明，請參閱您的 AI 應用程式中有關如何使用資源的文件。

1. matlab_coding_guidelines

   • 提供全面的 MATLAB 編碼標準，以改善程式碼的可讀性、可維護性和協作性。這些指南涵蓋命名慣例、格式化、註解、效能最佳化和錯誤處理。
   • URI：guidelines://coding
   • MIME 類型：text/markdown
   • 來源：MATLAB Coding Standards (GitHub)

2. plain_text_live_code_guidelines

   • 提供使用純文字 Live Code .m 檔案格式產生即時指令碼的規則和指南，適用於版本控制和 AI 輔助開發。請注意，要執行純文字即時指令碼，您需要 MATLAB R2025a 或更新版本。有關詳細資訊，請參閱 Live Code File Format (MathWorks)。
   • URI：guidelines://plain-text-live-code
   • MIME 類型：text/markdown
   • 來源：Plain Text Live Code Generation (GitHub)

資料收集

MATLAB MCP Server 可能會收集有關您使用伺服器的完全匿名資訊，並將其傳送給 MathWorks。此資料收集有助於 MathWorks 改進產品，且預設為啟用。若要選擇退出資料收集，請將引數 --disable-telemetry 設為 true。

安全性考量

使用 MATLAB MCP Server 時，您應在執行所有工具呼叫前，徹底審查並驗證它們。對於重要操作，請務必保持人為監督，並且只有在您確信該呼叫會完全按照您的預期執行時才繼續。如需更多資訊，請參閱 User Interaction Model (MCP) 和 Security Considerations (MCP)。

授權與使用

授權條款可在本 GitHub 儲存庫的 LICENSE.md 檔案中找到。

MCP 伺服器僅允許根據 MathWorks 軟體授權協議與 MATLAB 搭配使用，且不得由多個使用者共用。如果您需要支援共用或集中式伺服器使用，請聯絡 MathWorks。

聯絡支援

MathWorks 鼓勵您使用此儲存庫並提供回饋。若要請求技術支援或提交增強功能請求，請建立 GitHub 議題或聯絡 MathWorks 技術支援。

---

版權所有 2025-2026 The MathWorks, Inc.

---