MATLAB MCP Core Server

MATLAB MCP Server

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

Führen Sie MATLAB® mit KI-Anwendungen aus, und zwar mit dem offiziellen MATLAB MCP Server von MathWorks®. Der MATLAB MCP Server ermöglicht Ihren KI-Anwendungen Folgendes:

• MATLAB starten und beenden.
• MATLAB-Code schreiben und ausführen.
• Ihren MATLAB-Code auf Stil und Korrektheit prüfen.

Um Ihrem Agenten bei der Verwendung von MATLAB und Simulink zu helfen, können Sie Skills aus dem MATLAB Agentic Toolkit (GitHub) und dem Simulink Agentic Toolkit (GitHub) verwenden, die diesen MCP-Server auch für Sie installieren können.

Inhaltsverzeichnis

• Einrichtung
  • Claude Code
  • Claude Desktop
  • GitHub Copilot in Visual Studio Code
  • Codex
• Argumente
• Tools
• Ressourcen
• Datenerfassung
• Sicherheitshinweise
• Lizenzierung und Nutzung
• Support kontaktieren

Einrichtung

1. Installieren Sie MATLAB (MathWorks) R2021a oder höher und fügen Sie es zum System-PATH hinzu.

2. Der Server unterstützt jede KI-Anwendung, die das Model Context Protocol verwendet. Um den MATLAB MCP Server für Claude Desktop einzurichten, springen Sie zu den Anweisungen für Claude Desktop. Um den Server für andere Anwendungen einzurichten, folgen Sie diesen Anweisungen:

   • Für Windows oder Linux die neueste Version herunterladen. (Alternativ können Sie aus dem Quellcode erstellen: Installieren Sie Go und erstellen Sie die Binärdatei mit go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest).

   • Für macOS laden Sie zunächst die neueste Version herunter, indem Sie den folgenden Befehl in Ihrem Terminal ausführen:

     • Für Apple-Silicon-Prozessoren führen Sie Folgendes aus:

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

     • Für Intel-Prozessoren führen Sie Folgendes aus:

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

     Erteilen Sie der heruntergeladenen Binärdatei anschließend Ausführungsberechtigungen, damit Sie den MATLAB MCP Server ausführen können:

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

3. Fügen Sie den MATLAB MCP Server zu Ihrer KI-Anwendung hinzu. Anweisungen zum Hinzufügen von MCP-Servern finden Sie in der Dokumentation Ihrer KI-Anwendung. Beispielanweisungen zur Verwendung von Claude Code®, Claude Desktop® und GitHub Copilot in Visual Studio® Code finden Sie unten. Beachten Sie, dass Sie den Server durch Angabe optionaler Argumente anpassen können.

Claude Code

Führen Sie in Ihrem Terminal den folgenden Befehl aus, und denken Sie daran, den vollständigen Pfad zur Server-Binärdatei einzufügen, die Sie bei der Einrichtung erworben haben:

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

Sie können den Server durch Angabe optionaler Argumente anpassen. Beachten Sie das ---Trennzeichen zwischen den Optionen von Claude Code und den Serverargumenten:

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

Details zum Hinzufügen von MCP-Servern in Claude Code finden Sie unter Lokalen stdio-Server hinzufügen (Claude Code). Um den Server später zu entfernen, führen Sie Folgendes aus:

claude mcp remove matlab

Claude Desktop

Sie installieren den MATLAB MCP Server in Claude Desktop mithilfe des MATLAB MCP Server-Bundles.

1. Installieren Sie die Filesystem-Erweiterung in Claude Desktop, damit Claude Dateien auf Ihrem System lesen und schreiben kann. Klicken Sie in Claude Desktop auf Einstellungen > Erweiterungen > Erweiterungen durchsuchen. Suchen Sie nach der von Anthropic entwickelten Filesystem-Erweiterung und klicken Sie auf Installieren. Geben Sie die Ordner an, auf die der MCP-Server zugreifen darf, und schalten Sie dann die Schaltfläche Deaktiviert auf Aktivieren um, um die Filesystem-Erweiterung zu aktivieren.

2. Laden Sie das MATLAB MCP Server-Bundle matlab-mcp-server.mcpb von der Seite Neueste Version herunter.

3. Um das MATLAB MCP Server-Bundle als Desktop-Erweiterung zu installieren, doppelklicken Sie auf die heruntergeladene Datei matlab-mcp-server.mcpb und klicken Sie in Claude Desktop auf Installieren. (Alternativ navigieren Sie in Claude zu Dateimenü > Einstellungen > Erweiterungen > Erweiterte Einstellungen > Erweiterung installieren und wählen die Datei matlab-mcp-server.mcpb aus. Klicken Sie auf Installieren).

Um das Verhalten des MATLAB MCP Servers anzupassen, navigieren Sie zu Einstellungen > Erweiterungen > Konfigurieren, wo Sie die Argumente des Servers ändern können.

GitHub Copilot in Visual Studio Code

Erstellen Sie in Ihrem VS-Code-Arbeitsbereich eine Datei mit dem Namen .vscode/mcp.json. Fügen Sie das folgende JSON ein, und denken Sie daran, den vollständigen Pfad zur Server-Binärdatei anzugeben, die Sie bei der Einrichtung erworben haben, sowie alle Argumente. Speichern Sie dann die Datei. (Beachten Sie, dass Ihre Pfade unter Windows zusätzliche Schrägstriche als Escape-Zeichen erfordern).

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

Weitere Informationen zur Verwendung von MCP-Servern in VS Code finden Sie unter MCP-Server in VS Code hinzufügen und verwalten (VS Code).

Codex

Führen Sie in Ihrem Terminal den folgenden Befehl aus, und denken Sie daran, den vollständigen Pfad zur Server-Binärdatei einzufügen, die Sie bei der Einrichtung erworben haben:

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

Sie können den Server durch Angabe optionaler Argumente anpassen. Zum Beispiel:

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

[!HINWEIS] Windows-Benutzer: Codex leitet die Umgebungsvariable WINDIR nicht weiter, die Sie zum Ausführen von MATLAB und Simulink benötigen (siehe #32).

Um die Variable hinzuzufügen, öffnen Sie Ihre Codex-Konfigurationsdatei unter C:\Users\<username>\.codex\config.toml und fügen Sie env_vars = ["WINDIR"] zum Abschnitt [mcp_servers.matlab] hinzu:

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

Argumente

Passen Sie das Verhalten des Servers an, indem Sie Argumente auf eine der folgenden Arten angeben:

• Fügen Sie die Argumente in die Konfigurationseinstellungen Ihrer KI-Anwendung ein (normalerweise eine .json-Datei).
• Geben Sie die Argumente als Befehlszeilenschnittstellen-Flags (CLI-Flags) ein, wenn Sie den Server starten.
• Verwenden Sie Umgebungsvariablen, die entweder in Ihrer CLI oder in den Konfigurationseinstellungen der Anwendung angegeben werden. Um den Namen der Umgebungsvariablen aus einem CLI-Flag abzuleiten, fügen Sie das Präfix MW_MCP_SERVER_ hinzu, konvertieren Sie in Großbuchstaben und ersetzen Sie Bindestriche (-) durch Unterstriche (_). Beispielsweise wird das Argument --matlab-root zur Umgebungsvariablen MW_MCP_SERVER_MATLAB_ROOT. CLI-Flags haben Vorrang vor Umgebungsvariablen, wenn Sie beide verwenden.

Argument	Beschreibung	Beispiel
help	Zeigt Hilfeinformationen für alle Argumente an.	--help
version	Zeigt die Version des MATLAB MCP Servers an.	--version
matlab-root	Vollständiger Pfad, der angibt, welches MATLAB gestartet werden soll. Fügen Sie /bin nicht in den Pfad ein. Standardmäßig versucht der Server, das erste MATLAB im System-PATH zu finden.	Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a Als Umgebungsvariable: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a
initialize-matlab-on-startup	Um MATLAB sofort beim Start des Servers zu initialisieren, setzen Sie dieses Argument auf true. Standardmäßig startet MATLAB erst, wenn das erste Tool aufgerufen wird.	--initialize-matlab-on-startup=true
initial-working-folder	Geben Sie den Ordner an, in dem MATLAB startet. Wenn Sie keinen Wert angeben, startet MATLAB im Pfad des ersten Root (MCP) Ihrer KI-Anwendung. Wenn Sie kein Root definiert haben, startet MATLAB an diesen Speicherorten: 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	Geben Sie an, ob der MATLAB-Desktop angezeigt werden soll. Verwenden Sie den Modus desktop (Standard), um den MATLAB-Desktop anzuzeigen. Verwenden Sie den Modus nodesktop, um MATLAB nur über Ihre KI-Anwendung zu verwenden, ohne den MATLAB-Desktop. Beachten Sie, dass im Modus nodesktop Befehle, die eine grafische Oberfläche erfordern (wie edit, open, open_system, uifigure und appdesigner), weiterhin MATLAB-Fenster auf Ihrem Desktop öffnen.	--matlab-display-mode=nodesktop
matlab-session-mode	Geben Sie an, ob der MCP-Server ein neues MATLAB startet oder eine Verbindung zu einer vorhandenen MATLAB-Sitzung herstellt (unterstützt ab MATLAB R2023a). Der Standard ist der Modus auto. Modus new: Der MCP-Server startet eine neue MATLAB-Sitzung. Modus auto (Standard): Der Server versucht, eine Verbindung zu einer vorhandenen MATLAB-Sitzung herzustellen, die Sie gemäß den folgenden Anweisungen für den Modus existing konfiguriert haben müssen. Wenn der Server keine vorhandene MATLAB-Sitzung finden kann, startet er eine neue. Modus existing: Der Server versucht, eine Verbindung zu einer vorhandenen MATLAB-Sitzung herzustellen. Verwenden Sie diesen Modus nicht in Verbindung mit den Argumenten matlab-root, initial-working-folder oder matlab-display-mode. Sie müssen Ihre MATLAB-Sitzung zuvor für die Verwendung dieses Modus konfiguriert haben, und zwar mit diesen Schritten: Wenn Sie den Modus existing zum ersten Mal verwenden, führen Sie ./matlab-mcp-server --setup-matlab aus. Dieser Befehl installiert ein Add-on namens MATLAB MCP Server Toolbox in MATLAB. Sie können den Befehl mit anderen Argumenten aus dieser Tabelle anpassen. Um beispielsweise anzugeben, welches MATLAB zum Installieren der Toolbox verwendet werden soll, können Sie ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a verwenden. Für Claude Desktop müssen Sie die MATLAB MCP Server-Binärdatei gemäß den Anweisungen unter Einrichtung herunterladen, bevor Sie ./matlab-mcp-server --setup-matlab ausführen. Führen Sie im Befehlsfenster einer laufenden MATLAB-Sitzung shareMATLABSession() aus. Der MCP-Server stellt eine Verbindung zu diesem MATLAB her, wenn Sie den Server mit --matlab-session-mode=existing oder --matlab-session-mode=auto starten. Wenn Sie mehrere MATLAB-Sitzungen ausführen, stellt der Server eine Verbindung zu der MATLAB-Sitzung her, in der Sie den Befehl shareMATLABSession() zuletzt ausgeführt haben. Alternativ zum manuellen Ausführen von shareMATLABSession() können Sie den Befehl zu Ihrem MATLAB-Startskript (MathWorks) hinzufügen.	--matlab-session-mode=existing
extension-file	Um benutzerdefinierte MCP-Tools zu verwenden, geben Sie einen Pfad zu einer JSON-Datei an, die Ihre Tools definiert. Sie können auch mehrere Erweiterungsdateien verwenden. Details zur Verwendung benutzerdefinierter Tools finden Sie unter Benutzerdefinierte Tools mit dem MATLAB MCP Server verwenden.	Windows: --extension-file=C:\\Users\\name\\my-tools.json Linux/macOS: --extension-file=/path/to/my-tools.json Verwendung mehrerer Erweiterungsdateien: 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 Verwendung von Umgebungsvariablen: 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	Geben Sie den Ordner an, in dem der MCP-Server Protokolldateien speichert. Wenn nicht angegeben, verwendet der Server den standardmäßigen temporären Ordner Ihres Betriebssystems.	Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp Linux/macOS: --log-folder=/tmp/my-logs
log-level	Die Protokollebenen des MCP-Servers. Gültige Werte in absteigender Ausführlichkeit sind debug, info, warn und error. Der Standardwert ist info.	--log-level=debug
disable-telemetry	Um die anonymisierte Datenerfassung zu deaktivieren, setzen Sie dieses Argument auf true. Details finden Sie unter Datenerfassung.	--disable-telemetry=true

Tools

1. detect_matlab_toolboxes

   • Gibt Informationen zu installierten MATLAB- und Toolboxen zurück, einschließlich Versionsnummern.

2. check_matlab_code

   • Führt eine statische Codeanalyse eines MATLAB-Skripts durch. Gibt Warnungen zu Codierungsstil, potenziellen Fehlern, veralteten Funktionen, Leistungsproblemen und Verstößen gegen Best Practices zurück. Dies ist ein nicht-destruktiver, schreibgeschützter Vorgang, der hilft, Probleme der Codequalität zu identifizieren, ohne das Skript auszuführen.
   • Eingaben:
     • script_path (Zeichenfolge): Absoluter Pfad zur zu analysierenden MATLAB-Skriptdatei. Muss eine gültige .m-Datei sein. Die Datei wird während der Analyse nicht geändert. Beispiel: C:\Users\username\matlab\myFunction.m oder /home/user/scripts/analysis.m.

3. evaluate_matlab_code

   • Wertet eine Zeichenfolge mit MATLAB-Code aus und gibt die Ausgabe zurück.
   • Eingaben:
     • code (Zeichenfolge): MATLAB-Code, der ausgewertet werden soll.
     • project_path (Zeichenfolge): Absoluter Pfad zu Ihrem Projektverzeichnis. MATLAB legt dieses Verzeichnis als aktuellen Arbeitsordner fest. Beispiel: C:\Users\username\matlab-project oder /home/user/research.

4. run_matlab_file

   • Führt ein MATLAB-Skript aus und gibt die Ausgabe zurück. Das Skript muss eine gültige .m file sein.
   • Eingaben:
     • script_path (Zeichenfolge): Absoluter Pfad zur auszuführenden MATLAB-Skriptdatei. Muss eine gültige .m-Datei sein. Beispiel: C:\Users\username\projects\analysis.m oder /home/user/matlab/simulation.m.

5. run_matlab_test_file

   • Führt ein MATLAB-Testskript aus und gibt umfassende Testergebnisse zurück. Speziell für MATLAB-Unit-Testdateien entwickelt, die den Konventionen des MATLAB-Testframeworks folgen.
   • Eingaben:
     • script_path (Zeichenfolge): Absoluter Pfad zur MATLAB-Testskriptdatei. Muss eine gültige .m-Datei sein, die MATLAB-Unit-Tests enthält. Beispiel: C:\Users\username\tests\testMyFunction.m oder /home/user/matlab/tests/test_analysis.m.

Ressourcen

Der MCP-Server stellt Ressourcen (MCP) bereit, um Ihrer KI-Anwendung beim Schreiben von MATLAB-Code zu helfen. Anweisungen zur Verwendung dieser Ressource finden Sie in der Dokumentation Ihrer KI-Anwendung, die erklärt, wie Ressourcen verwendet werden.

1. matlab_coding_guidelines

   • Bietet umfassende MATLAB-Codierungsstandards zur Verbesserung der Lesbarkeit, Wartbarkeit und Zusammenarbeit von Code. Die Richtlinien umfassen Namenskonventionen, Formatierung, Kommentierung, Leistungsoptimierung und Fehlerbehandlung.
   • URI: guidelines://coding
   • MIME-Typ: text/markdown
   • Quelle: MATLAB-Codierungsstandards (GitHub)

2. plain_text_live_code_guidelines

   • Bietet Regeln und Richtlinien zum Erstellen von Live-Skripten mithilfe des Klartext-Live-Code-.m-Dateiformats, das für Versionskontrolle und KI-gestützte Entwicklung geeignet ist. Beachten Sie, dass Sie zum Ausführen von Klartext-Live-Skripten MATLAB R2025a oder neuer benötigen. Details finden Sie unter Live-Code-Dateiformat (MathWorks).
   • URI: guidelines://plain-text-live-code
   • MIME-Typ: text/markdown
   • Quelle: Klartext-Live-Code-Generierung (GitHub)

Datenerfassung

Der MATLAB MCP Server kann vollständig anonymisierte Informationen über Ihre Nutzung des Servers erfassen und an MathWorks senden. Diese Datenerfassung hilft MathWorks, Produkte zu verbessern, und ist standardmäßig aktiviert. Um die Datenerfassung zu deaktivieren, setzen Sie das Argument --disable-telemetry auf true.

Sicherheitshinweise

Bei der Verwendung des MATLAB MCP Servers sollten Sie alle Tool-Aufrufe gründlich prüfen und validieren, bevor Sie sie ausführen. Behalten Sie bei wichtigen Aktionen immer einen Menschen im Prozess und fahren Sie nur fort, wenn Sie sicher sind, dass der Aufruf genau das tut, was Sie erwarten. Weitere Informationen finden Sie unter Benutzerinteraktionsmodell (MCP) und Sicherheitshinweise (MCP).

Lizenzierung und Nutzung

Die Lizenz ist in der Datei LICENSE.md in diesem GitHub-Repository verfügbar.

MCP-Server dürfen nur in Übereinstimmung mit der MathWorks-Softwarelizenzvereinbarung mit MATLAB verwendet werden und dürfen nicht von mehreren Benutzern gemeinsam genutzt werden. Kontaktieren Sie MathWorks, wenn Sie Unterstützung für gemeinsame oder zentralisierte Servernutzung benötigen.

Support kontaktieren

MathWorks ermutigt Sie, dieses Repository zu nutzen und Feedback zu geben. Um technischen Support anzufordern oder einen Verbesserungsvorschlag einzureichen, erstellen Sie ein GitHub-Issue oder kontaktieren Sie den MathWorks Technical Support.

---

Copyright 2025-2026 The MathWorks, Inc.

---