MATLAB MCP Core Server

MATLAB MCP Server

English • Español • 日本語 • 한국어 • 简体中文

[!WARNING] Kể từ phiên bản v0.11.0, MATLAB MCP Core Server đã được đổi tên thành MATLAB MCP Server. Để sử dụng phiên bản mới nhất của máy chủ sau thay đổi này, bạn phải cập nhật cài đặt của mình.

Thay đổi	Hành động cần thực hiện
Tên tệp nhị phân Định dạng mới: matlab-mcp-server-<os>-<arch>[.exe] Ví dụ: matlab-mcp-server-windows-x64.exe	Cập nhật tên tệp nhị phân trong cài đặt cấu hình của ứng dụng AI, thường là tệp .json.
Toolbox Đã cập nhật và đổi tên: MATLAB MCP Core Server Toolbox → MATLAB MCP Server Toolbox	Cài đặt phiên bản toolbox mới nhất bằng cách chạy ./matlab-mcp-server --setup-matlab. Bạn cần toolbox để kết nối với các phiên MATLAB hiện có. Để biết chi tiết, hãy xem matlab-session-mode trong phần Arguments.
URL kho lưu trữ github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	Không cần. GitHub tự động chuyển hướng.
Gói MCP Đã cập nhật và đổi tên: matlab-mcp-core-server.mcpb → matlab-mcp-server.mcpb	Nếu bạn đã sử dụng gói MATLAB MCP để cài đặt máy chủ MCP trong Claude Desktop trước phiên bản v0.11.0, trước tiên hãy gỡ cài đặt máy chủ, sau đó tải xuống gói matlab-mcp-server.mcpb mới từ trang Latest Release và sử dụng nó để cài đặt lại máy chủ. Để biết chi tiết, hãy xem phần về Claude Desktop.
Mô-đun Go github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	Nếu bạn đang sử dụng mô-đun MATLAB MCP Core Server trong một dự án Go, hãy cập nhật tên mô-đun trong go.mod và các khai báo import của bạn.

Chạy MATLAB® bằng các ứng dụng AI với Máy chủ MATLAB MCP chính thức từ MathWorks®. Máy chủ MATLAB MCP cho phép các ứng dụng AI của bạn:

• Khởi động và thoát MATLAB.
• Viết và chạy mã MATLAB.
• Đánh giá mã MATLAB của bạn về phong cách và tính chính xác.

Để hỗ trợ tác nhân của bạn sử dụng MATLAB và Simulink, bạn có thể sử dụng các kỹ năng từ MATLAB Agentic Toolkit (GitHub) và Simulink Agentic Toolkit (GitHub), những công cụ này cũng có thể cài đặt máy chủ MCP này cho bạn.

Mục lục

• Thiết lập
  • Claude Code
  • Claude Desktop
  • GitHub Copilot trong Visual Studio Code
  • Codex
• Tham số
• Công cụ
• Tài nguyên
• Thu thập dữ liệu
• Cân nhắc về bảo mật
• Cấp phép và sử dụng
• Liên hệ hỗ trợ

Thiết lập

1. Cài đặt MATLAB (MathWorks) R2021a trở lên và thêm nó vào PATH hệ thống. Máy chủ MATLAB MCP hỗ trợ các phiên bản MATLAB trong năm năm trở lại đây.

2. Máy chủ hỗ trợ bất kỳ ứng dụng AI nào sử dụng Model Context Protocol. Để thiết lập Máy chủ MATLAB MCP cho Claude Desktop, hãy chuyển đến hướng dẫn cho Claude Desktop. Để thiết lập máy chủ cho các ứng dụng khác, hãy làm theo các hướng dẫn sau:

   • Đối với Windows hoặc Linux, Tải xuống Bản phát hành mới nhất. (Ngoài ra, bạn có thể xây dựng từ mã nguồn: cài đặt Go và xây dựng tệp nhị phân bằng cách sử dụng go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest).

   • Đối với macOS, trước tiên hãy tải xuống bản phát hành mới nhất bằng cách chạy lệnh sau trong terminal của bạn:

     • Đối với bộ xử lý Apple silicon, chạy:

       curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64
       

     • Đối với bộ xử lý Intel, chạy:

       curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64
       

     Sau đó cấp quyền thực thi cho tệp nhị phân đã tải xuống để bạn có thể chạy Máy chủ MATLAB MCP:

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

3. Thêm Máy chủ MATLAB MCP vào ứng dụng AI của bạn. Bạn có thể tìm thấy hướng dẫn thêm máy chủ MCP trong tài liệu của ứng dụng AI. Ví dụ về hướng dẫn sử dụng Claude Code®, Claude Desktop® và GitHub Copilot trong Visual Studio® Code, hãy xem bên dưới. Lưu ý rằng bạn có thể tùy chỉnh máy chủ bằng cách chỉ định các Tham số tùy chọn.

Claude Code

Trong terminal của bạn, chạy lệnh sau, nhớ chèn đường dẫn đầy đủ đến tệp nhị phân máy chủ bạn đã có được trong quá trình thiết lập:

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

Bạn có thể tùy chỉnh máy chủ bằng cách chỉ định các Tham số tùy chọn. Lưu ý dấu phân cách -- giữa các tùy chọn của Claude Code và các tham số máy chủ:

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

Để biết chi tiết về cách thêm máy chủ MCP trong Claude Code, hãy xem Thêm máy chủ stdio cục bộ (Claude Code). Để xóa máy chủ sau này, chạy:

claude mcp remove matlab

Claude Desktop

Bạn cài đặt Máy chủ MATLAB MCP trong Claude Desktop bằng gói Máy chủ MATLAB MCP.

1. Cài đặt tiện ích mở rộng Filesystem trong Claude Desktop để cho phép Claude đọc và ghi tệp trên hệ thống của bạn. Trong Claude Desktop, nhấp Settings > Extensions > Browse extensions. Tìm kiếm tiện ích mở rộng Filesystem do Anthropic phát triển và nhấp Install. Chỉ định các thư mục bạn muốn cho phép máy chủ MCP truy cập, sau đó chuyển nút Disabled thành Enable để kích hoạt tiện ích mở rộng Filesystem.

2. Tải xuống gói Máy chủ MATLAB MCP matlab-mcp-server.mcpb từ trang Latest Release.

3. Để cài đặt gói Máy chủ MATLAB MCP dưới dạng tiện ích mở rộng desktop, nhấp đúp vào tệp matlab-mcp-server.mcpb đã tải xuống và nhấp Install trong Claude Desktop. (Ngoài ra, điều hướng trong Claude đến File menu > Settings > Extensions > Advanced Settings > Install Extension và chọn tệp matlab-mcp-server.mcpb. Nhấp Install).

Để tùy chỉnh hành vi của Máy chủ MATLAB MCP, điều hướng đến Settings > Extensions > Configure, nơi bạn có thể sửa đổi các Tham số của máy chủ.

GitHub Copilot trong Visual Studio Code

Trong không gian làm việc VS Code của bạn, tạo một tệp có tên .vscode/mcp.json. Chèn JSON sau, nhớ chỉ định đường dẫn đầy đủ đến tệp nhị phân máy chủ bạn đã có được trong quá trình thiết lập, cũng như bất kỳ Tham số nào. Sau đó lưu tệp. (Lưu ý rằng trên Windows, đường dẫn của bạn yêu cầu thêm dấu gạch chéo làm ký tự thoát).

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

Để biết thêm thông tin về việc sử dụng máy chủ MCP trong VS Code, hãy xem Thêm và Quản lý máy chủ MCP trong VS Code (VS Code).

Codex

Trong terminal của bạn, chạy lệnh sau, nhớ chèn đường dẫn đầy đủ đến tệp nhị phân máy chủ bạn đã có được trong quá trình thiết lập:

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

Bạn có thể tùy chỉnh máy chủ bằng cách chỉ định các Tham số tùy chọn. Ví dụ:

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

[!NOTE] Người dùng Windows: Codex không chuyển tiếp biến môi trường WINDIR, biến mà bạn cần để chạy MATLAB và Simulink (xem #32).

Để thêm biến, hãy mở tệp cấu hình Codex của bạn tại C:\Users\<username>\.codex\config.toml, và thêm env_vars = ["WINDIR"] vào phần [mcp_servers.matlab]:

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

Tham số

Tùy chỉnh hành vi của máy chủ bằng cách chỉ định tham số theo một trong những cách sau:

• Chèn các tham số vào cài đặt cấu hình của ứng dụng AI (thường là tệp .json).
• Nhập các tham số dưới dạng cờ giao diện dòng lệnh (CLI) khi bạn khởi động máy chủ.
• Sử dụng biến môi trường, được chỉ định trong CLI hoặc cài đặt cấu hình của ứng dụng. Để lấy tên biến môi trường từ một cờ CLI, thêm tiền tố MW_MCP_SERVER_, chuyển đổi thành chữ hoa và thay thế dấu gạch nối (-) bằng dấu gạch dưới (_). Ví dụ: tham số --matlab-root trở thành biến môi trường MW_MCP_SERVER_MATLAB_ROOT. Cờ CLI được ưu tiên hơn biến môi trường, nếu bạn sử dụng cả hai. | Đối số | Mô tả | Ví dụ | | ------------- | ------------- | ------------- | | help | Hiển thị thông tin trợ giúp cho tất cả các đối số. | --help | | version | Hiển thị phiên bản của MATLAB MCP Server. | --version | | matlab-root | Đường dẫn đầy đủ chỉ định MATLAB nào sẽ khởi động. Không bao gồm /bin trong đường dẫn. Theo mặc định, máy chủ sẽ cố gắng tìm MATLAB đầu tiên trên PATH hệ thống. | Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a
  
  Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a
  
  Dưới dạng biến môi trường: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a | | initialize-matlab-on-startup | Để khởi tạo MATLAB ngay khi bạn khởi động máy chủ, hãy đặt đối số này thành true. Theo mặc định, MATLAB chỉ khởi động khi công cụ đầu tiên được gọi. | --initialize-matlab-on-startup=true | | initial-working-folder | Chỉ định thư mục nơi MATLAB khởi động. Nếu bạn không chỉ định giá trị, MATLAB sẽ khởi động tại đường dẫn của Root (MCP) đầu tiên của ứng dụng AI. Nếu bạn chưa xác định root, MATLAB sẽ khởi động tại các vị trí sau:
  
  • 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 | Chỉ định có hiển thị desktop MATLAB hay không. Sử dụng chế độ desktop (mặc định) để hiển thị desktop MATLAB. Sử dụng chế độ nodesktop để chỉ sử dụng MATLAB từ ứng dụng AI của bạn, không có desktop MATLAB. Lưu ý rằng ở chế độ nodesktop, các lệnh yêu cầu giao diện đồ họa (chẳng hạn như edit, open, open_system, uifigure và appdesigner) vẫn sẽ mở các cửa sổ MATLAB trên desktop của bạn. | --matlab-display-mode=nodesktop | | matlab-session-mode | Chỉ định máy chủ MCP khởi động một MATLAB mới hay kết nối đến một phiên MATLAB hiện có (được hỗ trợ từ MATLAB R2023a trở đi). Mặc định là chế độ auto.
  
  Chế độ new: Máy chủ MCP khởi động một phiên MATLAB mới.
  
  Chế độ auto (mặc định): Máy chủ cố gắng kết nối đến một phiên MATLAB hiện có mà bạn phải đã cấu hình cho chế độ existing bằng các hướng dẫn bên dưới. Nếu máy chủ không thể tìm thấy phiên MATLAB hiện có, nó sẽ khởi động một phiên mới.
  
  Chế độ existing: Máy chủ cố gắng kết nối đến một phiên MATLAB hiện có. Bạn phải cấu hình trước phiên MATLAB của mình để sử dụng chế độ này, với các bước sau:
  
  
  1. Nếu bạn đang sử dụng chế độ existing lần đầu tiên, hãy chạy ./matlab-mcp-server --setup-matlab.
     
     Lệnh này cài đặt một add-on có tên MATLAB MCP Server Toolbox trong MATLAB. Bạn có thể tùy chỉnh lệnh với các đối số khác từ bảng này. Ví dụ: để chỉ định MATLAB nào sẽ được dùng để cài đặt toolbox, bạn có thể sử dụng ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a.
     
     Đối với Claude Desktop, bạn phải tải xuống tệp nhị phân MATLAB MCP Server bằng các hướng dẫn trong Setup trước khi chạy ./matlab-mcp-server --setup-matlab.
     
     
  2. Trong cửa sổ lệnh của một phiên MATLAB đang chạy, hãy chạy shareMATLABSession(). Máy chủ MCP sẽ kết nối đến MATLAB này khi bạn khởi động máy chủ với --matlab-session-mode=existing hoặc --matlab-session-mode=auto. Nếu bạn đang chạy nhiều phiên MATLAB, máy chủ sẽ kết nối đến phiên MATLAB nơi bạn chạy lệnh shareMATLABSession() gần đây nhất.
     
     Thay vì chạy shareMATLABSession() thủ công, bạn có thể thêm lệnh vào Startup Script (MathWorks) MATLAB của mình.
  | --matlab-session-mode=existing | | extension-file | Để sử dụng các công cụ MCP tùy chỉnh, hãy cung cấp đường dẫn đến tệp JSON định nghĩa các công cụ của bạn. Bạn cũng có thể sử dụng nhiều tệp mở rộng. Để biết chi tiết về cách sử dụng công cụ tùy chỉnh, hãy xem 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
  
  Sử dụng nhiều tệp mở rộng:
  
  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
  
  Sử dụng biến môi trường:
  
  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 | Chỉ định thư mục nơi máy chủ MCP lưu trữ các tệp nhật ký. Nếu không được chỉ định, máy chủ sẽ sử dụng thư mục tạm thời mặc định của hệ điều hành. | Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp
  
  Linux/macOS: --log-folder=/tmp/my-logs | | log-level | Các mức nhật ký của máy chủ MCP. Các giá trị hợp lệ, theo thứ tự độ chi tiết giảm dần, là debug, info, warn và error. | --log-level=debug | | disable-telemetry | Để tắt thu thập dữ liệu ẩn danh, hãy đặt đối số này thành true. Để biết chi tiết, hãy xem Data Collection. | --disable-telemetry=true |

Công cụ

1. detect_matlab_toolboxes

   • Trả về thông tin về MATLAB và các toolbox đã cài đặt, bao gồm số phiên bản.

2. check_matlab_code

   • Thực hiện phân tích mã tĩnh trên một tập lệnh MATLAB. Trả về các cảnh báo về phong cách lập trình, lỗi tiềm ẩn, hàm không còn được dùng, vấn đề hiệu năng và vi phạm thực hành tốt nhất. Đây là thao tác không phá hủy, chỉ đọc, giúp xác định các vấn đề chất lượng mã mà không cần thực thi tập lệnh.
   • Đầu vào:
     • script_path (chuỗi): Đường dẫn tuyệt đối đến tệp tập lệnh MATLAB cần phân tích. Phải là tệp .m hợp lệ. Tệp không bị sửa đổi trong quá trình phân tích. Ví dụ: C:\Users\username\matlab\myFunction.m hoặc /home/user/scripts/analysis.m.

3. evaluate_matlab_code

   • Đánh giá một chuỗi mã MATLAB và trả về đầu ra.
   • Đầu vào:
     • code (chuỗi): Mã MATLAB cần đánh giá.
     • project_path (chuỗi): Đường dẫn tuyệt đối đến thư mục dự án của bạn. MATLAB đặt thư mục này làm thư mục làm việc hiện tại. Ví dụ: C:\Users\username\matlab-project hoặc /home/user/research.

4. run_matlab_file

   • Thực thi một tập lệnh MATLAB và trả về đầu ra. Tập lệnh phải là .m file hợp lệ.
   • Đầu vào:
     • script_path (chuỗi): Đường dẫn tuyệt đối đến tệp tập lệnh MATLAB cần thực thi. Phải là tệp .m hợp lệ. Ví dụ: C:\Users\username\projects\analysis.m hoặc /home/user/matlab/simulation.m.

5. run_matlab_test_file

   • Thực thi một tập lệnh kiểm thử MATLAB và trả về kết quả kiểm thử toàn diện. Được thiết kế riêng cho các tệp kiểm thử đơn vị MATLAB tuân theo quy ước của khung kiểm thử MATLAB.
   • Đầu vào:
     • script_path (chuỗi): Đường dẫn tuyệt đối đến tệp tập lệnh kiểm thử MATLAB. Phải là tệp .m hợp lệ chứa các bài kiểm thử đơn vị MATLAB. Ví dụ: C:\Users\username\tests\testMyFunction.m hoặc /home/user/matlab/tests/test_analysis.m.

Tài nguyên

Máy chủ MCP cung cấp Resources (MCP) để giúp ứng dụng AI của bạn viết mã MATLAB. Để xem hướng dẫn sử dụng tài nguyên này, hãy tham khảo tài liệu của ứng dụng AI giải thích cách sử dụng tài nguyên.

1. matlab_coding_guidelines

   • Cung cấp các tiêu chuẩn lập trình MATLAB toàn diện để cải thiện khả năng đọc, bảo trì và cộng tác mã. Các hướng dẫn bao gồm quy ước đặt tên, định dạng, chú thích, tối ưu hóa hiệu năng và xử lý lỗi.
   • URI: guidelines://coding
   • MIME Type: text/markdown
   • Nguồn: MATLAB Coding Standards (GitHub)

2. plain_text_live_code_guidelines

   • Cung cấp các quy tắc và hướng dẫn để tạo live script bằng định dạng tệp văn bản thuần túy Live Code .m, phù hợp cho kiểm soát phiên bản và phát triển có hỗ trợ AI. Lưu ý rằng để chạy live script văn bản thuần túy, bạn cần MATLAB R2025a trở lên. Để biết chi tiết, hãy xem Live Code File Format (MathWorks).
   • URI: guidelines://plain-text-live-code
   • MIME Type: text/markdown
   • Nguồn: Plain Text Live Code Generation (GitHub)

Thu thập dữ liệu

MATLAB MCP Server có thể thu thập thông tin ẩn danh hoàn toàn về việc sử dụng máy chủ của bạn và gửi đến MathWorks. Việc thu thập dữ liệu này giúp MathWorks cải thiện sản phẩm và được bật theo mặc định. Để từ chối thu thập dữ liệu, hãy đặt đối số --disable-telemetry thành true.

Cân nhắc về bảo mật

Khi sử dụng MATLAB MCP Server, bạn nên xem xét và xác thực kỹ lưỡng tất cả các lệnh gọi công cụ trước khi chạy chúng. Luôn giữ con người trong vòng lặp đối với các hành động quan trọng và chỉ tiếp tục khi bạn tự tin rằng lệnh gọi sẽ thực hiện chính xác những gì bạn mong đợi. Để biết thêm thông tin, hãy xem User Interaction Model (MCP) và Security Considerations (MCP).

Cấp phép và Sử dụng

Giấy phép có sẵn trong tệp LICENSE.md trong kho lưu trữ GitHub này.

Máy chủ MCP chỉ được phép sử dụng với MATLAB theo Thỏa thuận Cấp phép Phần mềm MathWorks và không được chia sẻ cho nhiều người dùng. Liên hệ MathWorks nếu bạn cần hỗ trợ sử dụng máy chủ dùng chung hoặc tập trung.

Liên hệ Hỗ trợ

MathWorks khuyến khích bạn sử dụng kho lưu trữ này và cung cấp phản hồi. Để yêu cầu hỗ trợ kỹ thuật hoặc gửi yêu cầu cải tiến, hãy tạo một GitHub issue hoặc liên hệ MathWorks Technical Support.

---

Bản quyền 2025-2026 The MathWorks, Inc.

---