MATLAB MCP Core Server

MATLAB MCP Sunucusu

İngilizce • İspanyolca • Japonca • Korece • Basitleştirilmiş Çince

MathWorks®'ün resmi MATLAB MCP Sunucusu ile AI uygulamalarını kullanarak MATLAB® çalıştırın. MATLAB MCP Sunucusu, AI uygulamalarınızın şunları yapmasını sağlar:

• MATLAB'ı başlatma ve kapatma.
• MATLAB kodu yazma ve çalıştırma.
• MATLAB kodunuzu stil ve doğruluk açısından değerlendirme.

Ajanınızın MATLAB ve Simulink kullanmasına yardımcı olmak için, MATLAB Agentic Toolkit (GitHub) ve Simulink Agentic Toolkit (GitHub) içindeki becerileri kullanabilirsiniz; bu araç setleri bu MCP sunucusunu sizin için de kurabilir.

İçindekiler

• Kurulum
  • Claude Code
  • Claude Desktop
  • Visual Studio Code'da GitHub Copilot
  • Codex
• Argümanlar
• Araçlar
• Kaynaklar
• Veri Toplama
• Güvenlik Hususları
• Lisanslama ve Kullanım
• Destek ile İletişim

Kurulum

1. MATLAB (MathWorks) R2021a veya sonraki bir sürümü kurun ve sistem PATH'ine ekleyin.

2. Sunucu, Model Context Protocol kullanan herhangi bir AI uygulamasını destekler. MATLAB MCP Sunucusu'nu Claude Desktop için kurmak üzere Claude Desktop talimatlarına geçin. Sunucuyu diğer uygulamalar için kurmak üzere şu talimatları izleyin:

   • Windows veya Linux için En Son Sürümü İndirin. (Alternatif olarak, kaynak koddan derleyebilirsiniz: Go kurun ve go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest kullanarak ikili dosyayı derleyin).

   • macOS için, önce terminalinizde aşağıdaki komutu çalıştırarak en son sürümü indirin:

     • Apple silicon işlemciler için şunu çalıştırın:

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

     • Intel işlemciler için şunu çalıştırın:

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

     Ardından, MATLAB MCP Sunucusu'nu çalıştırabilmeniz için indirilen ikili dosyaya yürütme izinleri verin:

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

3. MATLAB MCP Sunucusu'nu AI uygulamanıza ekleyin. AI uygulamanızın belgelerinde MCP sunucularını ekleme talimatlarını bulabilirsiniz. Claude Code®, Claude Desktop® ve Visual Studio® Code'da GitHub Copilot kullanımına ilişkin örnek talimatlar için aşağıya bakın. İsteğe bağlı Argümanları belirterek sunucuyu özelleştirebileceğinizi unutmayın.

Claude Code

Terminalinizde, kurulumda edindiğiniz sunucu ikili dosyasının tam yolunu eklemeyi unutmadan aşağıdakini çalıştırın:

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

İsteğe bağlı Argümanları belirterek sunucuyu özelleştirebilirsiniz. Claude Code'un seçenekleri ile sunucu argümanları arasındaki -- ayırıcısına dikkat edin:

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

Claude Code'da MCP sunucuları ekleme hakkında ayrıntılı bilgi için bkz. Yerel bir stdio sunucusu ekleme (Claude Code). Sunucuyu daha sonra kaldırmak için şunu çalıştırın:

claude mcp remove matlab

Claude Desktop

MATLAB MCP Sunucusu'nu Claude Desktop'a MATLAB MCP Sunucusu paketini kullanarak kurarsınız.

1. Claude'ın sisteminizdeki dosyaları okumasına ve yazmasına izin vermek için Claude Desktop'a Filesystem uzantısını kurun. Claude Desktop'ta Ayarlar > Uzantılar > Uzantılara Göz At seçeneğine tıklayın. Anthropic tarafından geliştirilen Filesystem uzantısını arayın ve Kur'a tıklayın. MCP sunucusunun erişmesine izin vermek istediğiniz klasörleri belirtin, ardından Filesystem uzantısını etkinleştirmek için Devre Dışı düğmesini Etkin konumuna getirin.

2. MATLAB MCP Sunucusu paketini matlab-mcp-server.mcpb En Son Sürüm sayfasından indirin.

3. MATLAB MCP Sunucusu paketini bir masaüstü uzantısı olarak kurmak için, indirilen matlab-mcp-server.mcpb dosyasına çift tıklayın ve Claude Desktop'ta Kur'a tıklayın. (Alternatif olarak, Claude'da Dosya menüsü > Ayarlar > Uzantılar > Gelişmiş Ayarlar > Uzantı Kur bölümüne gidin ve matlab-mcp-server.mcpb dosyasını seçin. Kur'a tıklayın).

MATLAB MCP Sunucusu'nun davranışını özelleştirmek için Ayarlar > Uzantılar > Yapılandır bölümüne gidin; burada sunucunun Argümanlarını değiştirebilirsiniz.

Visual Studio Code'da GitHub Copilot

VS Code çalışma alanınızda .vscode/mcp.json adında bir dosya oluşturun. Kurulumda edindiğiniz sunucu ikili dosyasının tam yolunu ve herhangi bir Argümanı belirtmeyi unutmadan aşağıdaki JSON'u ekleyin. Ardından dosyayı kaydedin. (Windows'ta yollarınızın kaçış karakterleri olarak ekstra eğik çizgi gerektirdiğini unutmayın).

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

VS Code'da MCP sunucularını kullanma hakkında daha fazla bilgi için bkz. VS Code'da MCP sunucuları ekleme ve yönetme (VS Code).

Codex

Terminalinizde, kurulumda edindiğiniz sunucu ikili dosyasının tam yolunu eklemeyi unutmadan aşağıdakini çalıştırın:

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

İsteğe bağlı Argümanları belirterek sunucuyu özelleştirebilirsiniz. Örneğin:

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

[!NOT] Windows kullanıcıları: Codex, MATLAB ve Simulink'i çalıştırmak için ihtiyaç duyduğunuz WINDIR ortam değişkenini iletmez (bkz. #32).

Değişkeni eklemek için Codex yapılandırma dosyanızı C:\Users\<username>\.codex\config.toml konumunda açın ve env_vars = ["WINDIR"] değerini [mcp_servers.matlab] bölümüne ekleyin:

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

Argümanlar

Sunucunun davranışını şu yollardan biriyle argümanlar belirterek özelleştirin:

• Argümanları AI uygulamanızın yapılandırma ayarlarına ekleyin (genellikle bir .json dosyası).
• Sunucuyu başlattığınızda argümanları komut satırı arabirimi (CLI) bayrakları olarak girin.
• CLI'nizde veya uygulamanızın yapılandırma ayarlarında belirtilen ortam değişkenlerini kullanın. Bir CLI bayrağından ortam değişkeni adı türetmek için MW_MCP_SERVER_ önekini ekleyin, büyük harfe dönüştürün ve tireleri (-) alt çizgilerle (_) değiştirin. Örneğin, --matlab-root argümanı MW_MCP_SERVER_MATLAB_ROOT ortam değişkeni olur. Her ikisini de kullanırsanız CLI bayrakları ortam değişkenlerine göre önceliklidir.

Argüman	Açıklama	Örnek
help	Tüm argümanlar için yardım bilgilerini görüntüler.	--help
version	MATLAB MCP Sunucusu'nun sürümünü görüntüler.	--version
matlab-root	Hangi MATLAB'in başlatılacağını belirten tam yol. Yola /bin eklemeyin. Varsayılan olarak sunucu, sistem PATH'inde ilk MATLAB'i bulmaya çalışır.	Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a Ortam değişkeni olarak: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a
initialize-matlab-on-startup	MATLAB'i sunucuyu başlattığınız anda başlatmak için bu argümanı true olarak ayarlayın. Varsayılan olarak MATLAB yalnızca ilk araç çağrıldığında başlar.	--initialize-matlab-on-startup=true
initial-working-folder	MATLAB'in başladığı klasörü belirtin. Bir değer belirtmezseniz MATLAB, AI uygulamanızın ilk Kök (MCP) yolunda başlar. Bir kök tanımlamadıysanız MATLAB şu konumlarda başlar: 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	MATLAB masaüstünün gösterilip gösterilmeyeceğini belirtin. MATLAB masaüstünü göstermek için desktop modunu (varsayılan) kullanın. MATLAB'i yalnızca AI uygulamanızdan, MATLAB masaüstü olmadan kullanmak için nodesktop modunu kullanın. nodesktop modunda grafik arayüz gerektiren komutların (edit, open, open_system, uifigure ve appdesigner gibi) masaüstünüzde yine de MATLAB pencereleri açacağını unutmayın.	--matlab-display-mode=nodesktop
matlab-session-mode	MCP sunucusunun yeni bir MATLAB başlatıp başlatmayacağını veya mevcut bir MATLAB oturumuna bağlanıp bağlanmayacağını belirtin (MATLAB R2023a ve sonrası için desteklenir). Varsayılan auto modudur. new modu: MCP sunucusu yeni bir MATLAB oturumu başlatır. auto modu (varsayılan): Sunucu, aşağıdaki talimatları kullanarak existing modu için yapılandırmış olmanız gereken mevcut bir MATLAB oturumuna bağlanmaya çalışır. Sunucu mevcut bir MATLAB oturumu bulamazsa yeni bir tane başlatır. existing modu: Sunucu mevcut bir MATLAB oturumuna bağlanmaya çalışır. Bu modu matlab-root, initial-working-folder veya matlab-display-mode argümanlarıyla birlikte kullanmayın. Bu modu kullanmak için MATLAB oturumunuzu önceden şu adımlarla yapılandırmış olmalısınız: existing modunu ilk kez kullanıyorsanız ./matlab-mcp-server --setup-matlab komutunu çalıştırın. Bu komut MATLAB'e MATLAB MCP Sunucusu Araç Kutusu adlı bir eklenti kurar. Komutu bu tablodaki diğer argümanlarla özelleştirebilirsiniz. Örneğin, araç kutusunu kurmak için hangi MATLAB'in kullanılacağını belirtmek üzere ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a kullanabilirsiniz. Claude Desktop için, ./matlab-mcp-server --setup-matlab komutunu çalıştırmadan önce Kurulum bölümündeki talimatları kullanarak MATLAB MCP Sunucusu ikili dosyasını indirmelisiniz. Çalışan bir MATLAB oturumunun komut penceresinde shareMATLABSession() komutunu çalıştırın. MCP sunucusu, sunucuyu --matlab-session-mode=existing veya --matlab-session-mode=auto ile başlattığınızda bu MATLAB'e bağlanacaktır. Birden çok MATLAB oturumu çalıştırıyorsanız sunucu, shareMATLABSession() komutunu en son çalıştırdığınız MATLAB oturumuna bağlanır. shareMATLABSession() komutunu manuel olarak çalıştırmaya alternatif olarak, komutu MATLAB Başlangıç Betiğinize (MathWorks) ekleyebilirsiniz.	--matlab-session-mode=existing
extension-file	Özel MCP araçları kullanmak için araçlarınızı tanımlayan bir JSON dosyasının yolunu sağlayın. Birden çok uzantı dosyası da kullanabilirsiniz. Özel araçları kullanma hakkında ayrıntılı bilgi için bkz. MATLAB MCP Sunucusu ile Özel Araçlar Kullanma.	Windows: --extension-file=C:\\Users\\name\\my-tools.json Linux/macOS: --extension-file=/path/to/my-tools.json Birden çok uzantı dosyası kullanma: 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 Ortam değişkenlerini kullanma: 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	MCP sunucusunun günlük dosyalarını sakladığı klasörü belirtin. Belirtilmezse sunucu, işletim sisteminizin varsayılan geçici klasörünü kullanır.	Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp Linux/macOS: --log-folder=/tmp/my-logs
log-level	MCP sunucusunun günlük düzeyleri. Azalan ayrıntı düzeyi sırasına göre geçerli değerler debug, info, warn ve error şeklindedir. Varsayılan info değeridir.	--log-level=debug
disable-telemetry	Anonimleştirilmiş veri toplamayı devre dışı bırakmak için bu argümanı true olarak ayarlayın. Ayrıntılar için bkz. Veri Toplama.	--disable-telemetry=true

Araçlar

1. detect_matlab_toolboxes

   • Sürüm numaraları dahil olmak üzere kurulu MATLAB ve araç kutuları hakkında bilgi döndürür.

2. check_matlab_code

   • MATLAB betik dosyası üzerinde statik kod analizi gerçekleştirir. Kodlama stili, olası hatalar, kullanımdan kaldırılmış fonksiyonlar, performans sorunları ve en iyi uygulama ihlalleri hakkında uyarılar döndürür. Bu, betiği çalıştırmadan kod kalitesi sorunlarını belirlemeye yardımcı olan, yıkıcı olmayan, salt okunur bir işlemdir.
   • Girdiler:
     • script_path (dize): Analiz edilecek MATLAB betik dosyasının mutlak yolu. Geçerli bir .m dosyası olmalıdır. Analiz sırasında dosya değiştirilmez. Örnek: C:\Users\username\matlab\myFunction.m veya /home/user/scripts/analysis.m.

3. evaluate_matlab_code

   • Bir MATLAB kodu dizesini değerlendirir ve çıktıyı döndürür.
   • Girdiler:
     • code (dize): Değerlendirilecek MATLAB kodu.
     • project_path (dize): Proje dizininizin mutlak yolu. MATLAB bu dizini geçerli çalışma klasörü olarak ayarlar. Örnek: C:\Users\username\matlab-project veya /home/user/research.

4. run_matlab_file

   • Bir MATLAB betiğini çalıştırır ve çıktıyı döndürür. Betik, geçerli bir MATLAB kaynak dosyası (.m) veya P-kod dosyası (.p) olmalıdır. Bir MATLAB kaynak dosyası (.m) ve bir P-kod dosyası (.p) aynı ada sahipse ve aynı klasördeyse, MATLAB .p dosyasını çalıştırır.
   • Girdiler:
     • script_path (dize): Çalıştırılacak MATLAB betik dosyasının mutlak yolu. Geçerli bir MATLAB kaynak dosyası (.m) veya P-kod dosyası (.p) olmalıdır. Örnek: C:\Users\username\projects\analysis.m veya /home/user/matlab/simulation.m.

5. run_matlab_test_file

   • Bir MATLAB test betiğini çalıştırır ve kapsamlı test sonuçları döndürür. MATLAB test çerçevesi kurallarını izleyen MATLAB birim test dosyaları için özel olarak tasarlanmıştır.
   • Girdiler:
     • script_path (dize): MATLAB test betik dosyasının mutlak yolu. MATLAB birim testleri içeren geçerli bir MATLAB kaynak dosyası (.m) veya P-kod dosyası (.p) olmalıdır. Örnek: C:\Users\username\tests\testMyFunction.m veya /home/user/matlab/tests/test_analysis.m.

Kaynaklar

MCP sunucusu, yapay zeka uygulamanızın MATLAB kodu yazmasına yardımcı olmak için Kaynaklar (MCP) sağlar. Bu kaynağı kullanma talimatlarını görmek için, kaynakların nasıl kullanılacağını açıklayan yapay zeka uygulamanızın belgelerine bakın.

1. matlab_coding_guidelines

   • Kod okunabilirliğini, sürdürülebilirliğini ve iş birliğini geliştirmek için kapsamlı MATLAB kodlama standartları sağlar. Yönergeler; adlandırma kuralları, biçimlendirme, yorumlama, performans optimizasyonu ve hata işlemeyi kapsar.
   • URI: guidelines://coding
   • MIME Türü: text/markdown
   • Kaynak: MATLAB Kodlama Standartları (GitHub)

2. plain_text_live_code_guidelines

   • Sürüm kontrolü ve yapay zeka destekli geliştirme için uygun, düz metin Live Code .m dosya biçimini kullanarak canlı betikler oluşturmaya yönelik kurallar ve yönergeler sağlar. Düz metin canlı betikleri çalıştırmak için MATLAB R2025a veya daha yeni bir sürüme ihtiyacınız olduğunu unutmayın. Ayrıntılar için bkz. Live Code Dosya Biçimi (MathWorks).
   • URI: guidelines://plain-text-live-code
   • MIME Türü: text/markdown
   • Kaynak: Düz Metin Live Code Oluşturma (GitHub)

Veri Toplama

MATLAB MCP Sunucusu, sunucu kullanımınız hakkında tamamen anonimleştirilmiş bilgiler toplayabilir ve bunları MathWorks'e gönderebilir. Bu veri toplama, MathWorks'ün ürünleri iyileştirmesine yardımcı olur ve varsayılan olarak açıktır. Veri toplamayı devre dışı bırakmak için --disable-telemetry bağımsız değişkenini true olarak ayarlayın.

Güvenlik Konuları

MATLAB MCP Sunucusunu kullanırken, çalıştırmadan önce tüm araç çağrılarını kapsamlı bir şekilde incelemeli ve doğrulamalısınız. Önemli işlemler için her zaman sürece bir insanı dahil edin ve yalnızca çağrının tam olarak beklediğinizi yapacağından emin olduğunuzda devam edin. Daha fazla bilgi için bkz. Kullanıcı Etkileşim Modeli (MCP) ve Güvenlik Konuları (MCP).

Lisans ve Kullanım

Lisans, bu GitHub deposundaki LICENSE.md dosyasında mevcuttur.

MCP sunucularının yalnızca MathWorks Yazılım Lisans Sözleşmesi'ne uygun olarak MATLAB ile kullanılmasına izin verilir ve birden fazla kullanıcı tarafından paylaşılmamalıdır. Paylaşılan veya merkezi sunucu kullanımı desteğine ihtiyacınız varsa MathWorks ile iletişime geçin.

Destek ile İletişim

MathWorks, bu depoyu kullanmanızı ve geri bildirim sağlamanızı teşvik eder. Teknik destek talep etmek veya bir iyileştirme isteği göndermek için bir GitHub sorunu oluşturun veya MathWorks Teknik Destek ile iletişime geçin.

---

Telif Hakkı 2025-2026 The MathWorks, Inc.

---