MATLAB MCP Core Server

resmi

Jalankan MATLAB® menggunakan aplikasi AI dengan server MCP MATLAB resmi dari MathWorks®.

Apa yang bisa Anda lakukan dengan MATLAB Core MCP?

  • Jalankan kode MATLAB secara langsung — minta asisten untuk menjalankan potongan kode dengan evaluate_matlab_code dan mengembalikan output.
  • Jalankan skrip dan pengujian MATLAB — minta eksekusi file .m melalui run_matlab_file atau rangkaian pengujian unit melalui run_matlab_test_file.
  • Periksa kualitas kode tanpa menjalankannya — minta asisten menganalisis skrip untuk kesalahan, masalah gaya, dan fungsi yang tidak digunakan lagi menggunakan check_matlab_code.
  • Ambil standar pengkodean MATLAB — akses sumber daya matlab_coding_guidelines untuk praktik terbaik penamaan, pemformatan, dan kinerja.
  • Dapatkan aturan skrip langsung teks biasa — rujuk sumber daya plain_text_live_code_guidelines saat menghasilkan skrip langsung yang ramah kontrol versi.

Dokumentasi

MATLAB MCP Server

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

[!WARNING] Mulai v0.11.0, MATLAB MCP Core Server telah berganti nama menjadi MATLAB MCP Server. Untuk menggunakan versi terbaru server setelah perubahan ini, Anda harus memperbarui pengaturan Anda.

PerubahanTindakan yang Diperlukan
Nama biner
Format baru: matlab-mcp-server-<os>-<arch>[.exe]
Contoh: matlab-mcp-server-windows-x64.exe
Perbarui nama biner di pengaturan konfigurasi aplikasi AI Anda, biasanya berupa file .json.
Toolbox
Diperbarui dan diganti nama: MATLAB MCP Core Server ToolboxMATLAB MCP Server Toolbox
Instal versi terbaru toolbox dengan menjalankan ./matlab-mcp-server --setup-matlab. Anda memerlukan toolbox untuk terhubung ke sesi MATLAB yang ada. Untuk detailnya, lihat matlab-session-mode di bagian Arguments.
URL Repositori
github.com/matlab/matlab-mcp-core-servergithub.com/matlab/matlab-mcp-server
Tidak ada. GitHub mengalihkan secara otomatis.
Bundel MCP
Diperbarui dan diganti nama: matlab-mcp-core-server.mcpbmatlab-mcp-server.mcpb
Jika Anda menggunakan bundel MATLAB MCP untuk menginstal server MCP di Claude Desktop sebelum v0.11.0, hapus instalan server terlebih dahulu, lalu unduh bundel matlab-mcp-server.mcpb baru dari halaman Latest Release dan gunakan untuk menginstal ulang server. Untuk detailnya, lihat bagian tentang Claude Desktop.
Modul Go
github.com/matlab/matlab-mcp-core-servergithub.com/matlab/matlab-mcp-server
Jika Anda menggunakan modul MATLAB MCP Core Server dalam proyek Go, perbarui nama modul di go.mod dan deklarasi impor Anda.

Jalankan MATLAB® menggunakan aplikasi AI dengan MATLAB MCP Server resmi dari MathWorks®. MATLAB MCP Server memungkinkan aplikasi AI Anda untuk:

  • Memulai dan keluar dari MATLAB.
  • Menulis dan menjalankan kode MATLAB.
  • Menilai kode MATLAB Anda untuk gaya dan kebenaran.

Untuk membantu agen Anda dalam menggunakan MATLAB dan Simulink, Anda dapat menggunakan keterampilan dari MATLAB Agentic Toolkit (GitHub) dan Simulink Agentic Toolkit (GitHub), yang juga dapat menginstal server MCP ini untuk Anda.

Daftar Isi

Setup

  1. Instal MATLAB (MathWorks) R2021a atau yang lebih baru dan tambahkan ke PATH sistem. MATLAB MCP Server mendukung rilis MATLAB dari lima tahun terakhir.

  2. Server mendukung aplikasi AI apa pun yang menggunakan Model Context Protocol. Untuk menyiapkan MATLAB MCP Server untuk Claude Desktop, langsung ke instruksi untuk Claude Desktop. Untuk menyiapkan server untuk aplikasi lain, ikuti instruksi ini:

    • Untuk Windows atau Linux, Unduh Rilis Terbaru. (Atau, Anda dapat membangun dari sumber: instal Go dan bangun binernya menggunakan go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest).

    • Untuk macOS, pertama unduh rilis terbaru dengan menjalankan perintah berikut di terminal Anda:

      • Untuk prosesor Apple silicon, jalankan:
        curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64
        
      • Untuk prosesor Intel, jalankan:
        curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64
        

      Kemudian berikan izin eksekusi ke biner yang diunduh sehingga Anda dapat menjalankan MATLAB MCP Server:

      chmod +x ~/Downloads/matlab-mcp-server
      
  3. Tambahkan MATLAB MCP Server ke aplikasi AI Anda. Anda dapat menemukan instruksi untuk menambahkan server MCP di dokumentasi aplikasi AI Anda. Untuk contoh instruksi menggunakan Claude Code®, Claude Desktop®, dan GitHub Copilot di Visual Studio® Code, lihat di bawah. Perhatikan bahwa Anda dapat menyesuaikan server dengan menentukan Arguments opsional.

Claude Code

Di terminal Anda, jalankan perintah berikut, ingat untuk memasukkan path lengkap ke biner server yang Anda peroleh saat setup:

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

Anda dapat menyesuaikan server dengan menentukan Arguments opsional. Perhatikan pemisah -- antara opsi Claude Code dan argumen server:

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

Untuk detail tentang menambahkan server MCP di Claude Code, lihat Add a local stdio server (Claude Code). Untuk menghapus server nanti, jalankan:

claude mcp remove matlab

Claude Desktop

Anda menginstal MATLAB MCP Server di Claude Desktop menggunakan bundel MATLAB MCP Server.

  1. Instal ekstensi Filesystem di Claude Desktop untuk memungkinkan Claude membaca dan menulis file di sistem Anda. Di Claude Desktop, klik Settings > Extensions > Browse extensions. Cari ekstensi Filesystem yang dikembangkan oleh Anthropic dan klik Install. Tentukan folder yang ingin Anda izinkan untuk diakses server MCP, lalu alihkan tombol Disabled ke Enable untuk ekstensi Filesystem.

  2. Unduh bundel MATLAB MCP Server matlab-mcp-server.mcpb dari halaman Latest Release.

  3. Untuk menginstal bundel MATLAB MCP Server sebagai ekstensi desktop, klik dua kali file matlab-mcp-server.mcpb yang diunduh dan klik Install di Claude Desktop. (Atau, navigasikan di Claude ke File menu > Settings > Extensions > Advanced Settings > Install Extension dan pilih file matlab-mcp-server.mcpb. Klik Install).

Untuk menyesuaikan perilaku MATLAB MCP Server, navigasikan ke Settings > Extensions > Configure, di mana Anda dapat mengubah Arguments server.

GitHub Copilot di Visual Studio Code

Di ruang kerja VS Code Anda, buat file bernama .vscode/mcp.json. Masukkan JSON berikut, ingat untuk menentukan path lengkap ke biner server yang Anda peroleh saat setup, serta Arguments apa pun. Kemudian simpan file tersebut. (Perhatikan bahwa di Windows, path Anda memerlukan garis miring ekstra sebagai karakter escape).

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

Untuk informasi lebih lanjut tentang menggunakan server MCP di VS Code, lihat Add and Manage MCP servers in VS Code (VS Code).

Codex

Di terminal Anda, jalankan perintah berikut, ingat untuk memasukkan path lengkap ke biner server yang Anda peroleh saat setup:

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

Anda dapat menyesuaikan server dengan menentukan Arguments opsional. Contohnya:

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

[!NOTE] Pengguna Windows: Codex tidak meneruskan variabel lingkungan WINDIR, yang Anda perlukan untuk menjalankan MATLAB dan Simulink (lihat #32).

Untuk menambahkan variabel, buka file konfigurasi Codex Anda di C:\Users\<username>\.codex\config.toml, dan tambahkan env_vars = ["WINDIR"] ke bagian [mcp_servers.matlab]:

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

Arguments

Sesuaikan perilaku server dengan menentukan argumen melalui salah satu cara berikut:

  • Masukkan argumen di pengaturan konfigurasi aplikasi AI Anda (biasanya berupa file .json).
  • Masukkan argumen sebagai flag command-line interface (CLI) saat Anda memulai server.
  • Gunakan variabel lingkungan, yang ditentukan baik di CLI atau pengaturan konfigurasi aplikasi Anda. Untuk mendapatkan nama variabel lingkungan dari flag CLI, tambahkan prefiks MW_MCP_SERVER_, ubah ke huruf besar, dan ganti tanda hubung (-) dengan garis bawah (_). Misalnya, argumen --matlab-root menjadi variabel lingkungan MW_MCP_SERVER_MATLAB_ROOT. Flag CLI lebih diutamakan daripada variabel lingkungan, jika Anda menggunakan keduanya. | Argumen | Deskripsi | Contoh | | ------------- | ------------- | ------------- | | help | Menampilkan informasi bantuan untuk semua argumen. | --help | | version | Menampilkan versi MATLAB MCP Server. | --version | | matlab-root | Path lengkap yang menentukan MATLAB mana yang akan dijalankan. Jangan sertakan /bin di dalam path. Secara default, server mencoba menemukan MATLAB pertama pada PATH sistem. | Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a

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

    Sebagai variabel lingkungan: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a | | initialize-matlab-on-startup | Untuk menginisialisasi MATLAB segera setelah Anda memulai server, atur argumen ini ke true. Secara default, MATLAB hanya dimulai saat alat pertama dipanggil. | --initialize-matlab-on-startup=true | | initial-working-folder | Tentukan folder tempat MATLAB dimulai. Jika Anda tidak menentukan nilai, MATLAB dimulai pada path Root (MCP) pertama aplikasi AI Anda. Jika Anda belum mendefinisikan root, MATLAB dimulai di lokasi berikut:
    • 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 | Tentukan apakah akan menampilkan desktop MATLAB. Gunakan mode desktop (default) untuk menampilkan desktop MATLAB. Gunakan mode nodesktop untuk menggunakan MATLAB hanya dari aplikasi AI Anda, tanpa desktop MATLAB. Perhatikan bahwa dalam mode nodesktop, perintah yang memerlukan antarmuka grafis (seperti edit, open, open_system, uifigure, dan appdesigner) akan tetap membuka jendela MATLAB di desktop Anda. | --matlab-display-mode=nodesktop | | matlab-session-mode | Tentukan apakah MCP server memulai MATLAB baru atau terhubung ke sesi MATLAB yang sudah ada (didukung untuk MATLAB R2023a dan seterusnya). Defaultnya adalah mode auto.

    Mode new: MCP server memulai sesi MATLAB baru.

    Mode auto (default): Server mencoba terhubung ke sesi MATLAB yang sudah ada, yang harus telah Anda konfigurasikan untuk mode existing menggunakan instruksi di bawah ini. Jika server tidak dapat menemukan sesi MATLAB yang sudah ada, server akan memulai yang baru.

    Mode existing: Server mencoba terhubung ke sesi MATLAB yang sudah ada. Anda harus telah mengonfigurasi sesi MATLAB Anda sebelumnya untuk menggunakan mode ini, dengan langkah-langkah berikut:

    1. Jika Anda menggunakan mode existing untuk pertama kalinya, jalankan ./matlab-mcp-server --setup-matlab.

      Perintah ini menginstal add-on bernama MATLAB MCP Server Toolbox di MATLAB. Anda dapat menyesuaikan perintah dengan argumen lain dari tabel ini. Misalnya, untuk menentukan MATLAB mana yang akan digunakan untuk menginstal toolbox, Anda dapat menggunakan ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a.

      Untuk Claude Desktop, Anda harus mengunduh biner MATLAB MCP Server menggunakan instruksi di Setup sebelum Anda menjalankan ./matlab-mcp-server --setup-matlab.

    2. Di jendela perintah sesi MATLAB yang sedang berjalan, jalankan shareMATLABSession(). MCP server akan terhubung ke MATLAB ini saat Anda memulai server dengan --matlab-session-mode=existing atau --matlab-session-mode=auto. Jika Anda menjalankan beberapa sesi MATLAB, server terhubung ke sesi MATLAB tempat Anda terakhir kali menjalankan perintah shareMATLABSession().

      Sebagai alternatif untuk menjalankan shareMATLABSession() secara manual, Anda dapat menambahkan perintah tersebut ke Startup Script (MathWorks) MATLAB Anda.
    | --matlab-session-mode=existing | | extension-file | Untuk menggunakan alat MCP kustom, berikan path ke file JSON yang mendefinisikan alat Anda. Anda juga dapat menggunakan beberapa file ekstensi. Untuk detail tentang penggunaan alat kustom, lihat 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

    Menggunakan beberapa file ekstensi:

    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

    Menggunakan variabel lingkungan:

    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 | Tentukan folder tempat MCP server menyimpan file log. Jika tidak ditentukan, server menggunakan folder sementara default sistem operasi Anda. | Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp

    Linux/macOS: --log-folder=/tmp/my-logs | | log-level | Level log dari MCP server. Nilai yang valid, dalam urutan verbositas menurun, adalah debug, info, warn, dan error. | --log-level=debug | | disable-telemetry | Untuk menonaktifkan pengumpulan data anonim, atur argumen ini ke true. Untuk detailnya, lihat Data Collection. | --disable-telemetry=true |

Alat

  1. detect_matlab_toolboxes

    • Mengembalikan informasi tentang MATLAB dan toolbox yang terinstal, termasuk nomor versi.
  2. check_matlab_code

    • Melakukan analisis kode statis pada skrip MATLAB. Mengembalikan peringatan tentang gaya pengkodean, potensi kesalahan, fungsi usang, masalah kinerja, dan pelanggaran praktik terbaik. Ini adalah operasi baca-saja yang tidak merusak dan membantu mengidentifikasi masalah kualitas kode tanpa mengeksekusi skrip.
    • Input:
      • script_path (string): Path absolut ke file skrip MATLAB yang akan dianalisis. Harus berupa file .m yang valid. File tidak dimodifikasi selama analisis. Contoh: C:\Users\username\matlab\myFunction.m atau /home/user/scripts/analysis.m.
  3. evaluate_matlab_code

    • Mengevaluasi string kode MATLAB dan mengembalikan outputnya.
    • Input:
      • code (string): Kode MATLAB yang akan dievaluasi.
      • project_path (string): Path absolut ke direktori proyek Anda. MATLAB menetapkan direktori ini sebagai folder kerja saat ini. Contoh: C:\Users\username\matlab-project atau /home/user/research.
  4. run_matlab_file

    • Mengeksekusi skrip MATLAB dan mengembalikan outputnya. Skrip harus berupa .m file yang valid.
    • Input:
      • script_path (string): Path absolut ke file skrip MATLAB yang akan dieksekusi. Harus berupa file .m yang valid. Contoh: C:\Users\username\projects\analysis.m atau /home/user/matlab/simulation.m.
  5. run_matlab_test_file

    • Mengeksekusi skrip pengujian MATLAB dan mengembalikan hasil pengujian yang komprehensif. Dirancang khusus untuk file pengujian unit MATLAB yang mengikuti konvensi kerangka pengujian MATLAB.
    • Input:
      • script_path (string): Path absolut ke file skrip pengujian MATLAB. Harus berupa file .m yang valid yang berisi pengujian unit MATLAB. Contoh: C:\Users\username\tests\testMyFunction.m atau /home/user/matlab/tests/test_analysis.m.

Sumber Daya

MCP server menyediakan Resources (MCP) untuk membantu aplikasi AI Anda menulis kode MATLAB. Untuk melihat instruksi penggunaan sumber daya ini, lihat dokumentasi aplikasi AI Anda yang menjelaskan cara menggunakan sumber daya.

  1. matlab_coding_guidelines

    • Menyediakan standar pengkodean MATLAB yang komprehensif untuk meningkatkan keterbacaan, pemeliharaan, dan kolaborasi kode. Pedoman ini mencakup konvensi penamaan, pemformatan, komentar, optimasi kinerja, dan penanganan kesalahan.
    • URI: guidelines://coding
    • Tipe MIME: text/markdown
    • Sumber: MATLAB Coding Standards (GitHub)
  2. plain_text_live_code_guidelines

    • Menyediakan aturan dan pedoman untuk menghasilkan live script menggunakan format file teks biasa Live Code .m, yang cocok untuk kontrol versi dan pengembangan berbantuan AI. Perhatikan bahwa untuk menjalankan live script teks biasa, Anda memerlukan MATLAB R2025a atau yang lebih baru. Untuk detailnya, lihat Live Code File Format (MathWorks).
    • URI: guidelines://plain-text-live-code
    • Tipe MIME: text/markdown
    • Sumber: Plain Text Live Code Generation (GitHub)

Pengumpulan Data

MATLAB MCP Server dapat mengumpulkan informasi yang sepenuhnya anonim tentang penggunaan server Anda dan mengirimkannya ke MathWorks. Pengumpulan data ini membantu MathWorks meningkatkan produk dan aktif secara default. Untuk tidak ikut serta dalam pengumpulan data, atur argumen --disable-telemetry ke true.

Pertimbangan Keamanan

Saat menggunakan MATLAB MCP Server, Anda harus meninjau dan memvalidasi semua panggilan alat secara menyeluruh sebelum menjalankannya. Selalu libatkan manusia dalam pengambilan keputusan untuk tindakan penting dan hanya lanjutkan setelah Anda yakin panggilan tersebut akan melakukan persis seperti yang Anda harapkan. Untuk informasi lebih lanjut, lihat User Interaction Model (MCP) dan Security Considerations (MCP).

Lisensi dan Penggunaan

Lisensi tersedia di file LICENSE.md di repositori GitHub ini.

Server MCP hanya diizinkan untuk digunakan dengan MATLAB sesuai dengan Perjanjian Lisensi Perangkat Lunak MathWorks, dan tidak boleh dibagikan oleh banyak pengguna. Hubungi MathWorks jika Anda perlu mendukung penggunaan server bersama atau terpusat.

Hubungi Dukungan

MathWorks mendorong Anda untuk menggunakan repositori ini dan memberikan umpan balik. Untuk meminta dukungan teknis atau mengirimkan permintaan peningkatan, buat isu GitHub atau hubungi Dukungan Teknis MathWorks.


Hak Cipta 2025-2026 The MathWorks, Inc.