MATLAB MCP Core Server

MATLAB MCP Sunucusu

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

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

• MATLAB'ı başlatın ve kapatın.
• MATLAB kodu yazın ve çalıştırın.
• MATLAB kodunuzu stil ve doğruluk açısından değerlendirin.

Ajanınızın MATLAB ve Simulink kullanmasına yardımcı olmak için MATLAB Agentic Toolkit (GitHub) ve Simulink Agentic Toolkit (GitHub) becerilerini 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 İletişimi

Kurulum

1. MATLAB (MathWorks) R2021a veya sonraki bir sürümü kurun ve sistem PATH'ine ekleyin. MATLAB MCP Sunucusu, son beş yılın MATLAB sürümlerini destekler.

2. Sunucu, Model Context Protocol kullanan herhangi bir yapay zeka 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 ikili dosyayı go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest kullanarak 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 çalıştırılabilir izinleri verin:

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

3. MATLAB MCP Sunucusu'nu yapay zeka uygulamanıza ekleyin. MCP sunucularını ekleme talimatlarını yapay zeka uygulamanızın belgelerinde 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. Sunucuyu isteğe bağlı Argümanlar belirterek özelleştirebileceğinizi unutmayın.

Claude Code

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

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

Sunucuyu isteğe bağlı Argümanlar belirterek ö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 Yerel bir stdio sunucusu ekleme (Claude Code) bölümüne bakın. 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'un sisteminizdeki dosyaları okumasını ve yazmasını sağlamak 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 Argümanları belirtmeyi unutarak 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 unutarak aşağıdakini çalıştırın:

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

Sunucuyu isteğe bağlı Argümanlar belirterek ö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 ihtiyacınız olan 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 [mcp_servers.matlab] bölümüne env_vars = ["WINDIR"] 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ı yapay zeka uygulamanızın yapılandırma ayarlarına ekleyin (genellikle bir .json dosyası).
• Sunucuyu başlatırken argümanları komut satırı arayüzü (CLI) bayrakları olarak girin.
• CLI'nizde veya uygulamanızın yapılandırma ayarlarında belirtilen ortam değişkenlerini kullanın. Ortam değişkeni adını bir CLI bayrağından 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. İkisini 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	Sunucuyu başlattığınız anda MATLAB'i 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 yapay zeka 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 yapay zeka uygulamanızdan, MATLAB masaüstü olmadan kullanmak için nodesktop modunu kullanın. nodesktop modunda, grafiksel 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ğlanmayı dener. Sunucu mevcut bir MATLAB oturumu bulamazsa, yeni bir tane başlatır. existing modu: Sunucu mevcut bir MATLAB oturumuna bağlanmayı dener. Bu modu kullanmak için MATLAB oturumunuzu önceden şu adımlarla yapılandırmış olmanız gerekir: existing modunu ilk kez kullanıyorsanız, ./matlab-mcp-server --setup-matlab komutunu çalıştırın. Bu komut, MATLAB'de MATLAB MCP Server Toolbox 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ğlanır. Birden fazla 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 fazla 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 fazla 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ı depoladığı 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. Ayrıntı düzeyi azalan sırada 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

   • Kurulu MATLAB ve araç kutuları hakkında sürüm numaraları dahil bilgileri döndürür.

2. check_matlab_code

   • Bir MATLAB betiği üzerinde statik kod analizi gerçekleştirir. Kodlama stili, olası hatalar, kullanımdan kaldırılmış işlevler, 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 ve 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. Dosya analiz sırasında değiştirilmez. Örnek: C:\Users\username\matlab\myFunction.m veya /home/user/scripts/analysis.m.

3. evaluate_matlab_code

   • Bir MATLAB kod dizisini 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 .m file olmalıdır.
   • Girdiler:
     • script_path (dize): Çalıştırılacak MATLAB betik dosyasının mutlak yolu. Geçerli bir .m dosyası 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ına uyan 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 .m dosyası 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 başvurun.

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

   • Düz metin Live Code .m dosya biçimini kullanarak canlı betikler (live scripts) oluşturmak için kurallar ve yönergeler sağlar; sürüm kontrolü ve yapay zeka destekli geliştirme için uygundur. 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 Üretimi (GitHub)

Veri Toplama

MATLAB MCP Sunucusu, sunucuyu kullanımınız hakkında tamamen anonimleştirilmiş bilgiler toplayıp 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, tüm araç çağrılarını çalıştırmadan önce kapsamlı bir şekilde incelemeli ve doğrulamalısınız. Önemli işlemler için her zaman döngüde bir insan bulundurun ve yalnızca çağrının tam olarak beklediğiniz şeyi yapacağından emin olduktan sonra ilerleyin. Daha fazla bilgi için bkz. Kullanıcı Etkileşim Modeli (MCP) ve Güvenlik Konuları (MCP).

Lisanslama 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ını desteklemeniz gerekiyorsa 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.

---

Copyright 2025-2026 The MathWorks, Inc.

---