MATLAB MCP Core Server

offiziell

Führen Sie MATLAB® mit KI-Anwendungen über den offiziellen MATLAB MCP Server von MathWorks® aus.

GitHub

1.7k

Was kann man mit MATLAB Core MCP machen?

MATLAB-Code ausführen — Bitten Sie Ihre KI, MATLAB-Codeausschnitte zu bewerten und die Ausgabe über evaluate_matlab_code zurückzugeben.
Skripte und Tests ausführen — Lassen Sie Ihre KI .m- oder .p-Dateien, einschließlich Unit-Tests, ausführen und die Ergebnisse über run_matlab_file oder run_matlab_test_file zurückerhalten.
Codequalität prüfen — Fordern Sie eine statische Analyse eines MATLAB-Skripts auf Stil, Fehler und Best Practices mit check_matlab_code an.
MATLAB-Umgebung inspizieren — Bitten Sie Ihre KI, installierte MATLAB-Toolboxen und Versionsdetails mit detect_matlab_toolboxes aufzulisten.

Dokumentation

MATLAB MCP Server

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

Führen Sie MATLAB® mit KI-Anwendungen über den offiziellen MATLAB MCP Server von MathWorks® aus. Der MATLAB MCP Server ermöglicht Ihren KI-Anwendungen:

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

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

Einrichtung

Installieren Sie MATLAB (MathWorks) R2021a oder neuer und fügen Sie es zum System-PATH hinzu.
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 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 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 dann der heruntergeladenen Binärdatei Ausführungsberechtigungen, damit Sie den MATLAB MCP Server ausführen können:
```
chmod +x ~/Downloads/matlab-mcp-server
```
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 fügen Sie den vollständigen Pfad zur Server-Binärdatei ein, 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 aus:

claude mcp remove matlab

Claude Desktop

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

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.
Laden Sie das MATLAB MCP Server-Bundle matlab-mcp-server.mcpb von der Seite Neueste Version herunter.
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, wobei Sie den vollständigen Pfad zur Server-Binärdatei angeben, 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 fügen Sie den vollständigen Pfad zur Server-Binärdatei ein, 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

[!NOTE] 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 (_). Zum Beispiel 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 Werkzeug 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 Orten: 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 für den Modus `existing` gemäß den folgenden Anweisungen 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 diesen Modus konfiguriert haben, 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 in 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-Werkzeuge zu verwenden, geben Sie einen Pfad zu einer JSON-Datei an, die Ihre Werkzeuge definiert. Sie können auch mehrere Erweiterungsdateien verwenden. Details zur Verwendung benutzerdefinierter Werkzeuge finden Sie unter Benutzerdefinierte Werkzeuge 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 Standard 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`

Werkzeuge

detect_matlab_toolboxes
- Gibt Informationen über installierte MATLAB- und Toolboxen zurück, einschließlich Versionsnummern.
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.
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.
run_matlab_file
- Führt ein MATLAB-Skript aus und gibt die Ausgabe zurück. Das Skript muss eine gültige MATLAB-Quelldatei (.m) oder P-Code-Datei (.p) sein. Wenn eine MATLAB-Quelldatei (.m) und eine P-Code-Datei (.p) denselben Namen haben und sich im selben Ordner befinden, führt MATLAB die .p-Datei aus.
- Eingaben:
  - script_path (Zeichenfolge): Absoluter Pfad zur auszuführenden MATLAB-Skriptdatei. Muss eine gültige MATLAB-Quelldatei (.m) oder P-Code-Datei (.p) sein. Beispiel: C:\Users\username\projects\analysis.m oder /home/user/matlab/simulation.m.
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 MATLAB-Quelldatei (.m) oder P-Code-Datei (.p) 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.

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)
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 Toolaufrufe 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 eine gemeinsame oder zentralisierte Servernutzung unterstützen müssen.

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.