MATLAB MCP Core Server
resmiJalankan 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_codedan mengembalikan output. - Jalankan skrip dan pengujian MATLAB — minta eksekusi file
.mmelaluirun_matlab_fileatau rangkaian pengujian unit melaluirun_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_guidelinesuntuk praktik terbaik penamaan, pemformatan, dan kinerja. - Dapatkan aturan skrip langsung teks biasa — rujuk sumber daya
plain_text_live_code_guidelinessaat 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.
Perubahan Tindakan yang Diperlukan Nama biner
Format baru:matlab-mcp-server-<os>-<arch>[.exe]
Contoh:matlab-mcp-server-windows-x64.exePerbarui nama biner di pengaturan konfigurasi aplikasi AI Anda, biasanya berupa file .json.Toolbox
Diperbarui dan diganti nama:MATLAB MCP Core Server Toolbox→MATLAB MCP Server ToolboxInstal versi terbaru toolbox dengan menjalankan ./matlab-mcp-server --setup-matlab. Anda memerlukan toolbox untuk terhubung ke sesi MATLAB yang ada. Untuk detailnya, lihatmatlab-session-modedi bagian Arguments.URL Repositori github.com/matlab/matlab-mcp-core-server→github.com/matlab/matlab-mcp-serverTidak ada. GitHub mengalihkan secara otomatis. Bundel MCP
Diperbarui dan diganti nama:matlab-mcp-core-server.mcpb→matlab-mcp-server.mcpbJika 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.mcpbbaru 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-server→github.com/matlab/matlab-mcp-serverJika Anda menggunakan modul MATLAB MCP Core Server dalam proyek Go, perbarui nama modul di go.moddan 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
- Arguments
- Tools
- Resources
- Data Collection
- Security Considerations
- Licensing and Usage
- Contact Support
Setup
-
Instal MATLAB (MathWorks) R2021a atau yang lebih baru dan tambahkan ke PATH sistem. MATLAB MCP Server mendukung rilis MATLAB dari lima tahun terakhir.
-
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 - Untuk prosesor Apple silicon, jalankan:
-
-
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.
-
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.
-
Unduh bundel MATLAB MCP Server
matlab-mcp-server.mcpbdari halaman Latest Release. -
Untuk menginstal bundel MATLAB MCP Server sebagai ekstensi desktop, klik dua kali file
matlab-mcp-server.mcpbyang diunduh dan klik Install di Claude Desktop. (Atau, navigasikan di Claude ke File menu > Settings > Extensions > Advanced Settings > Install Extension dan pilih filematlab-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 tambahkanenv_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-rootmenjadi variabel lingkunganMW_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/bindi 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 ketrue. 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
--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 modedesktop(default) untuk menampilkan desktop MATLAB. Gunakan modenodesktopuntuk menggunakan MATLAB hanya dari aplikasi AI Anda, tanpa desktop MATLAB. Perhatikan bahwa dalam modenodesktop, perintah yang memerlukan antarmuka grafis (sepertiedit,open,open_system,uifigure, danappdesigner) 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 modeauto.
Modenew: MCP server memulai sesi MATLAB baru.
Modeauto(default): Server mencoba terhubung ke sesi MATLAB yang sudah ada, yang harus telah Anda konfigurasikan untuk modeexistingmenggunakan instruksi di bawah ini. Jika server tidak dapat menemukan sesi MATLAB yang sudah ada, server akan memulai yang baru.
Modeexisting: 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:- Jika Anda menggunakan mode
existinguntuk 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. - 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=existingatau--matlab-session-mode=auto. Jika Anda menjalankan beberapa sesi MATLAB, server terhubung ke sesi MATLAB tempat Anda terakhir kali menjalankan perintahshareMATLABSession().
Sebagai alternatif untuk menjalankanshareMATLABSession()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, adalahdebug,info,warn, danerror. |--log-level=debug| | disable-telemetry | Untuk menonaktifkan pengumpulan data anonim, atur argumen ini ketrue. Untuk detailnya, lihat Data Collection. |--disable-telemetry=true| - Linux:
Alat
-
detect_matlab_toolboxes- Mengembalikan informasi tentang MATLAB dan toolbox yang terinstal, termasuk nomor versi.
-
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.myang valid. File tidak dimodifikasi selama analisis. Contoh:C:\Users\username\matlab\myFunction.matau/home/user/scripts/analysis.m.
-
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-projectatau/home/user/research.
-
run_matlab_file- Mengeksekusi skrip MATLAB dan mengembalikan outputnya. Skrip harus berupa
.m fileyang valid. - Input:
script_path(string): Path absolut ke file skrip MATLAB yang akan dieksekusi. Harus berupa file.myang valid. Contoh:C:\Users\username\projects\analysis.matau/home/user/matlab/simulation.m.
- Mengeksekusi skrip MATLAB dan mengembalikan outputnya. Skrip harus berupa
-
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.myang valid yang berisi pengujian unit MATLAB. Contoh:C:\Users\username\tests\testMyFunction.matau/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.
-
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)
-
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)
- Menyediakan aturan dan pedoman untuk menghasilkan live script menggunakan format file teks biasa Live Code
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.