MATLAB MCP Core Server

Server MATLAB MCP

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

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

• Memulai dan menutup 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

• Pengaturan
  • Claude Code
  • Claude Desktop
  • GitHub Copilot di Visual Studio Code
  • Codex
• Argumen
• Alat
• Sumber Daya
• Pengumpulan Data
• Pertimbangan Keamanan
• Lisensi dan Penggunaan
• Hubungi Dukungan

Pengaturan

1. Instal MATLAB (MathWorks) R2021a atau yang lebih baru dan tambahkan ke PATH sistem.

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

   • Untuk Windows atau Linux, Unduh Rilis Terbaru. (Atau, Anda dapat membangun dari sumber: instal Go dan bangun biner 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 Server MATLAB MCP:

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

3. Tambahkan Server MATLAB MCP 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 Argumen opsional.

Claude Code

Di terminal Anda, jalankan perintah berikut, ingat untuk memasukkan jalur lengkap ke biner server yang Anda peroleh dalam pengaturan:

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

Anda dapat menyesuaikan server dengan menentukan Argumen 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 Tambahkan server stdio lokal (Claude Code). Untuk menghapus server nanti, jalankan:

claude mcp remove matlab

Claude Desktop

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

1. Instal ekstensi Filesystem di Claude Desktop untuk memungkinkan Claude membaca dan menulis file di sistem Anda. Di Claude Desktop, klik Pengaturan > Ekstensi > Jelajahi ekstensi. Cari ekstensi Filesystem yang dikembangkan oleh Anthropic dan klik Instal. Tentukan folder yang ingin Anda izinkan untuk diakses server MCP, lalu alihkan tombol Nonaktif ke Aktifkan untuk mengaktifkan ekstensi Filesystem.

2. Unduh bundel Server MATLAB MCP matlab-mcp-server.mcpb dari halaman Rilis Terbaru.

3. Untuk menginstal bundel Server MATLAB MCP sebagai ekstensi desktop, klik dua kali file matlab-mcp-server.mcpb yang diunduh dan klik Instal di Claude Desktop. (Atau, navigasikan di Claude ke Menu File > Pengaturan > Ekstensi > Pengaturan Lanjutan > Instal Ekstensi dan pilih file matlab-mcp-server.mcpb. Klik Instal).

Untuk menyesuaikan perilaku Server MATLAB MCP, navigasikan ke Pengaturan > Ekstensi > Konfigurasi, di mana Anda dapat memodifikasi Argumen server.

GitHub Copilot di Visual Studio Code

Di ruang kerja VS Code Anda, buat file bernama .vscode/mcp.json. Sisipkan JSON berikut, ingat untuk menentukan jalur lengkap ke biner server yang Anda peroleh dalam pengaturan, serta Argumen apa pun. Kemudian simpan file. (Perhatikan bahwa di Windows, jalur Anda memerlukan garis miring tambahan 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 Tambahkan dan Kelola server MCP di VS Code (VS Code).

Codex

Di terminal Anda, jalankan perintah berikut, ingat untuk memasukkan jalur lengkap ke biner server yang Anda peroleh dalam pengaturan:

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

Anda dapat menyesuaikan server dengan menentukan Argumen opsional. Misalnya:

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

[!CATATAN] 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"]

Argumen

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

• Sisipkan argumen dalam pengaturan konfigurasi aplikasi AI Anda (biasanya file .json).
• Masukkan argumen sebagai flag antarmuka baris perintah (CLI) saat Anda memulai server.
• Gunakan variabel lingkungan, ditentukan baik di CLI atau pengaturan konfigurasi aplikasi Anda. Untuk menurunkan nama variabel lingkungan dari flag CLI, tambahkan awalan MW_MCP_SERVER_, ubah menjadi 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 Server MATLAB MCP.	--version
matlab-root	Jalur lengkap yang menentukan MATLAB mana yang akan dimulai. Jangan sertakan /bin di jalur. Secara default, server mencoba menemukan MATLAB pertama di 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 ketika alat pertama dipanggil.	--initialize-matlab-on-startup=true
initial-working-folder	Tentukan folder tempat MATLAB dimulai. Jika Anda tidak menentukan nilai, MATLAB dimulai di jalur Root (MCP) pertama aplikasi AI Anda. Jika Anda belum menentukan 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 server MCP memulai MATLAB baru atau terhubung ke sesi MATLAB yang ada (didukung untuk MATLAB R2023a dan seterusnya). Defaultnya adalah mode auto. Mode new: Server MCP memulai sesi MATLAB baru. Mode auto (default): Server mencoba terhubung ke sesi MATLAB yang ada, yang harus Anda konfigurasikan untuk mode existing menggunakan instruksi di bawah. Jika server tidak dapat menemukan sesi MATLAB yang ada, server memulai yang baru. Mode existing: Server mencoba terhubung ke sesi MATLAB yang ada. Jangan gunakan mode ini bersama dengan argumen matlab-root, initial-working-folder, atau matlab-display-mode. Anda harus mengonfigurasi sesi MATLAB Anda sebelumnya untuk menggunakan mode ini, dengan langkah-langkah berikut: 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 Server MATLAB MCP menggunakan instruksi di Pengaturan sebelum menjalankan ./matlab-mcp-server --setup-matlab. Di jendela perintah sesi MATLAB yang berjalan, jalankan shareMATLABSession(). Server MCP akan terhubung ke MATLAB ini ketika 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 menjalankan perintah shareMATLABSession(). Sebagai alternatif untuk menjalankan shareMATLABSession() secara manual, Anda dapat menambahkan perintah ke Skrip Startup (MathWorks) MATLAB Anda.	--matlab-session-mode=existing
extension-file	Untuk menggunakan alat MCP kustom, berikan jalur ke file JSON yang mendefinisikan alat Anda. Anda juga dapat menggunakan beberapa file ekstensi. Untuk detail tentang menggunakan alat kustom, lihat Gunakan Alat Kustom dengan Server MATLAB MCP.	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 server MCP 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	Tingkat log server MCP. Nilai yang valid, dalam urutan penurunan verbositas, adalah debug, info, warn, dan error. Defaultnya adalah info.	--log-level=debug
disable-telemetry	Untuk menonaktifkan pengumpulan data anonim, atur argumen ini ke true. Untuk detail, lihat Pengumpulan Data.	--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 penulisan kode, potensi kesalahan, fungsi yang tidak digunakan lagi, masalah performa, dan pelanggaran praktik terbaik. Ini adalah operasi non-destruktif dan hanya-baca yang membantu mengidentifikasi masalah kualitas kode tanpa mengeksekusi skrip.
   • Input:
     • script_path (string): Jalur 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 keluarannya.
   • Input:
     • code (string): Kode MATLAB yang akan dievaluasi.
     • project_path (string): Jalur 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 keluarannya. Skrip harus berupa .m file yang valid.
   • Input:
     • script_path (string): Jalur 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 kerja pengujian MATLAB.
   • Input:
     • script_path (string): Jalur 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

Server MCP menyediakan Sumber Daya (MCP) untuk membantu aplikasi AI Anda menulis kode MATLAB. Untuk melihat petunjuk penggunaan sumber daya ini, lihat dokumentasi aplikasi AI Anda yang menjelaskan cara menggunakan sumber daya.

1. matlab_coding_guidelines

   • Menyediakan standar penulisan kode MATLAB yang komprehensif untuk meningkatkan keterbacaan kode, kemudahan pemeliharaan, dan kolaborasi. Pedoman ini mencakup konvensi penamaan, pemformatan, pemberian komentar, optimasi performa, dan penanganan kesalahan.
   • URI: guidelines://coding
   • Tipe MIME: text/markdown
   • Sumber: Standar Penulisan Kode MATLAB (GitHub)

2. plain_text_live_code_guidelines

   • Menyediakan aturan dan pedoman untuk membuat live script menggunakan format file Live Code .m teks biasa, 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 Format File Live Code (MathWorks).
   • URI: guidelines://plain-text-live-code
   • Tipe MIME: text/markdown
   • Sumber: Pembuatan Live Code Teks Biasa (GitHub)

Pengumpulan Data

Server MCP MATLAB dapat mengumpulkan informasi yang sepenuhnya dianonimkan tentang penggunaan server oleh Anda dan mengirimkannya ke MathWorks. Pengumpulan data ini membantu MathWorks meningkatkan produk dan aktif secara default. Untuk menyisih dari pengumpulan data, atur argumen --disable-telemetry menjadi true.

Pertimbangan Keamanan

Saat menggunakan Server MCP MATLAB, Anda harus meninjau dan memvalidasi semua panggilan alat secara menyeluruh sebelum menjalankannya. Selalu libatkan manusia untuk tindakan penting dan lanjutkan hanya setelah Anda yakin panggilan tersebut akan melakukan persis seperti yang Anda harapkan. Untuk informasi lebih lanjut, lihat Model Interaksi Pengguna (MCP) dan Pertimbangan Keamanan (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 digunakan bersama 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 masalah GitHub atau hubungi Dukungan Teknis MathWorks.

---

Hak Cipta 2025-2026 The MathWorks, Inc.

---