MATLAB MCP Core Server

chính thức

Chạy MATLAB® bằng các ứng dụng AI với máy chủ MATLAB MCP chính thức từ MathWorks®.

GitHub
1.5k
Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với MATLAB Core MCP?

  • Chạy mã MATLAB — Yêu cầu trợ lý AI của bạn thực thi các đoạn mã hoặc tập lệnh MATLAB và trả về kết quả đầu ra bằng evaluate_matlab_code hoặc run_matlab_file.
  • Phân tích chất lượng mã — Yêu cầu trợ lý của bạn thực hiện phân tích tĩnh trên tập lệnh MATLAB để xác định các vấn đề về phong cách, lỗi tiềm ẩn và vi phạm thực hành tốt nhất bằng check_matlab_code.
  • Chạy kiểm thử đơn vị — Yêu cầu trợ lý của bạn thực thi các tệp kiểm thử MATLAB và nhận kết quả kiểm thử toàn diện bằng run_matlab_test_file.
  • Kiểm tra các hộp công cụ đã cài đặt — Yêu cầu thông tin về các hộp công cụ MATLAB đã cài đặt và số phiên bản qua detect_matlab_toolboxes.
  • Truy cập hướng dẫn mã hóa — Yêu cầu trợ lý của bạn tham chiếu các tiêu chuẩn mã hóa MATLAB và quy tắc định dạng mã trực tiếp từ các tài nguyên matlab_coding_guidelines và plain_text_live_code_guidelines.

Tài liệu

Máy chủ MATLAB MCP

Tiếng Anh • Español • 日本語 • 한국어 • 简体中文

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 đúng đắn.

Để 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), các bộ 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

  1. Cài đặt MATLAB (MathWorks) R2021a trở lên và thêm nó vào PATH hệ thống.

  2. Máy chủ hỗ trợ bất kỳ ứng dụng AI nào sử dụng Giao thức Ngữ cảnh Mô hình (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 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 hướng dẫn thêm máy chủ MCP trong tài liệu của ứng dụng AI của bạn. 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 Đối 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 Đối 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 đối 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 vào Cài đặt > Tiện ích mở rộng > Duyệt tiện ích mở rộng. Tìm kiếm tiện ích mở rộng Filesystem do Anthropic phát triển và nhấp vào Cài đặt. 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 Đã tắt sang Bật cho 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 Bản phát hành mới nhất.

  3. Để cài đặt gói Máy chủ MATLAB MCP như một tiện ích mở rộng máy tính để bàn, nhấp đúp vào tệp matlab-mcp-server.mcpb đã tải xuống và nhấp vào Cài đặt trong Claude Desktop. (Ngoài ra, điều hướng trong Claude đến Trình đơn Tệp > Cài đặt > Tiện ích mở rộng > Cài đặt nâng cao > Cài đặt tiện ích mở rộng và chọn tệp matlab-mcp-server.mcpb. Nhấp vào Cài đặt).

Để tùy chỉnh hành vi của Máy chủ MATLAB MCP, điều hướng đến Cài đặt > Tiện ích mở rộng > Cấu hình, nơi bạn có thể sửa đổi Đối 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ỳ Đối 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ề cách 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 Đối số tùy chọn. Ví dụ:

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

[!LƯU Ý] Người dùng Windows: Codex không chuyển tiếp biến môi trường WINDIR, biến này 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"]

Đối số

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

  • Chèn các đối số vào cài đặt cấu hình của ứng dụng AI của bạn (thường là tệp .json).
  • Nhập các đối 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 các 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 của bạn. Để suy ra tên biến môi trường 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ụ: đối số --matlab-root trở thành biến môi trường MW_MCP_SERVER_MATLAB_ROOT. Cờ CLI có quyền ư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ụ
helpHiển thị thông tin trợ giúp cho tất cả các đối số.--help
versionHiển thị phiên bản của Máy chủ MATLAB MCP.--version
matlab-rootĐường dẫn đầy đủ chỉ định MATLAB nào để khởi động. Không bao gồm /bin trong đường dẫn. Theo mặc định, máy chủ 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ủ, đặ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-folderChỉ định thư mục nơi MATLAB khởi động. Nếu bạn không chỉ định giá trị, MATLAB khởi động tại đường dẫn của Root (MCP) đầu tiên của ứng dụng AI của bạn. Nếu bạn chưa xác định root, MATLAB 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-modeChỉ định có hiển thị màn hình nền MATLAB hay không. Sử dụng chế độ desktop (mặc định) để hiển thị màn hình nền MATLAB. Sử dụng chế độ nodesktop để sử dụng MATLAB chỉ từ ứng dụng AI của bạn, không có màn hình nền MATLAB. Lưu ý rằng trong 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ửa sổ MATLAB trên màn hình nền của bạn.--matlab-display-mode=nodesktop
matlab-session-modeChỉ định máy chủ MCP khởi động MATLAB mới hay kết nối với phiên MATLAB hiện có (được hỗ trợ cho MATLAB R2023a trở lên). 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 với một phiên MATLAB hiện có, phiên này 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 với một phiên MATLAB hiện có. Không sử dụng chế độ này kết hợp với các đối số matlab-root, initial-working-folder hoặc matlab-display-mode. Bạn phải đã cấu hình phiên MATLAB của mình trước để sử dụng chế độ này, với các bước sau:

  1. Nếu bạn 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 tiện ích bổ sung 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ẽ sử dụng để cài đặt hộp công cụ, 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 Máy chủ MATLAB MCP bằng các hướng dẫn trong Thiết lập 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, chạy shareMATLABSession(). Máy chủ MCP sẽ kết nối với 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ủ kết nối với phiên MATLAB nơi bạn chạy lệnh shareMATLABSession() gần đây nhất.

    Như một giải pháp thay thế cho việc chạy shareMATLABSession() thủ công, bạn có thể thêm lệnh vào Tập lệnh khởi động (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, cung cấp đường dẫn đến tệp JSON xác định các công cụ của bạn. Bạn cũng có thể sử dụng nhiều tệp tiện ích mở rộng. Để biết chi tiết về cách sử dụng các công cụ tùy chỉnh, hãy xem Sử dụng Công cụ Tùy chỉnh với Máy chủ MATLAB MCP.

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 tiện ích 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-folderChỉ đị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ử dụng thư mục tạm thời mặc định của hệ điều hành của bạn.Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp

Linux/macOS: --log-folder=/tmp/my-logs
log-levelCác mức nhật ký của máy chủ MCP. Các giá trị hợp lệ, theo thứ tự giảm dần độ chi tiết, là debug, info, warn và error. Mặc định là info.--log-level=debug
disable-telemetryĐể tắt thu thập dữ liệu ẩn danh, đặt đối số này thành true. Để biết chi tiết, hãy xem Thu thập dữ liệu.--disable-telemetry=true

Công cụ

  1. detect_matlab_toolboxes

    • Trả về thông tin về MATLAB và các hộp công cụ đã 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 viết mã, lỗi tiềm ẩn, hàm không được dùng nữa, vấn đề hiệu suất và vi phạm các thông lệ tốt nhất. Đây là thao tác chỉ đọc, không phá hủy, giúp xác định các vấn đề về chất lượng mã mà không 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ề kết quả đầ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ề kết quả đầ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 các 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 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 Tài nguyên (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 của bạn 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 viết mã MATLAB toàn diện để cải thiện khả năng đọc mã, khả năng bảo trì và cộng tác. 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 suất và xử lý lỗi.
    • URI: guidelines://coding
    • Loại MIME: text/markdown
    • Nguồn: Tiêu chuẩn viết mã MATLAB (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 Live Code .m dạng văn bản thuần túy, phù hợp cho kiểm soát phiên bản và phát triển hỗ trợ AI. Lưu ý rằng để chạy live script dạng 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 Định dạng tệp Live Code (MathWorks).
    • URI: guidelines://plain-text-live-code
    • Loại MIME: text/markdown
    • Nguồn: Tạo Live Code dạng văn bản thuần túy (GitHub)

Thu thập dữ liệu

Máy chủ MCP MATLAB 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 bảo mật

Khi sử dụng Máy chủ MCP MATLAB, 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. Luôn giữ con người trong vòng lặp cho 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 Mô hình tương tác người dùng (MCP) và Cân nhắc bảo mật (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ẻ bởi nhiều người dùng. Liên hệ với 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, tạo một vấn đề GitHub hoặc liên hệ Hỗ trợ kỹ thuật MathWorks.

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