ParaView MCP

Verbinden Sie ParaView mit LLM-Assistenten über das Model Context Protocol.

Der Python-Server basiert auf FastMCP 3.x. Die Unterstützung für die MCP-Spezifikation 2026-07-28 ist geplant, sobald FastMCP 4 eine stabile Version erreicht hat.

paraview-mcp-server besteht aus zwei Laufzeitkomponenten:

• ein ParaView-Plugin (C++/Qt), das eine TCP-Brücke innerhalb der ParaView-GUI bereitstellt

• ein Python-MCP-Server, der eine Verbindung zum Plugin herstellt und Tools für jeden MCP-Client bereitstellt

Voraussetzungen

• ParaView ≥ 5.13. Vorgefertigte Plugins sind für die unten aufgeführten genauen Versionen und Plattformen verfügbar; andere ParaView-Versionen erfordern einen Quellcode-Build gegen das passende SDK.

• uv

Related MCP server: MCP-Slicer

Schnellstart

Richten Sie zunächst das ParaView-Plugin ein. Fügen Sie dann den Python-MCP-Server mit einem Befehl zu Claude Code hinzu:

claude mcp add paraview -- uvx paraview-mcp-server

Öffnen Sie in ParaView Extras > ParaView MCP, starten Sie die Brücke und verbinden Sie sich von Claude Code aus.

Einrichten des ParaView-Plugins

Laden Sie ein vorgefertigtes Plugin-Binärpaket aus dem letzten GitHub-Release herunter. Releases bieten diese Matrix:

Wählen Sie das Paket, das Ihre genaue ParaView-Version und Plattform benennt. Laden Sie die dazugehörige .sha256-Datei herunter, überprüfen Sie das Paket, öffnen oder extrahieren Sie es und folgen Sie der enthaltenen INSTALL.md. Pull Requests erzeugen ebenfalls entsprechende Plattform-Binärdateien als kurzlebige GitHub Actions-Artefakte; GitHub Releases sind der dauerhafte Verteilungskanal.

macOS-Release-Images sind mit einer Developer-ID signiert, von Apple notariell beglaubigt und enthalten einen gehefteten Notarisierungsbeleg. Öffnen Sie die .dmg, kopieren Sie das enthaltene Plugin-Verzeichnis an einen dauerhaften Speicherort und laden Sie ParaViewMCP.so aus diesem kopierten Verzeichnis. Pull-Request-Artefakte sind unsignierte Test-Builds und bleiben .tar.gz-Dateien.

Alternativ können Sie das Plugin aus dem Quellcode gegen ein ParaView 5.13 oder neueres SDK erstellen. Siehe CONTRIBUTING.md für vollständige Build-Anweisungen. Die Binärkompatibilität ist release-serienspezifisch, verwenden Sie daher ein Plugin, das für Ihre ParaView-Haupt- und Nebenversion erstellt wurde.

Nach der Installation:

1. Öffnen Sie in ParaView Extras > Plugins verwalten.

2. Klicken Sie Neu laden... und wählen Sie ParaViewMCP.so (Linux/macOS) oder ParaViewMCP.dll (Windows) aus dem Plugin-Verzeichnis.

3. Aktivieren Sie Automatisch laden.

4. Öffnen Sie Extras > ParaView MCP.

5. Klicken Sie Server starten.

Das ParaView-MCP-Panel zeigt den Verbindungsstatus und den Ausführungsverlauf an. Nicht-Loopback-Bindungen erfordern ein Authentifizierungstoken.

Konfigurieren Ihres MCP-Clients

Claude Code (CLI)

claude mcp add paraview -- uvx paraview-mcp-server

Claude Desktop

Fügen Sie Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "paraview": {
      "command": "uvx",
      "args": ["paraview-mcp-server"]
    }
  }
}

Andere MCP-Clients

Konfigurieren Sie einen lokalen stdio-MCP-Server mit uvx als Befehl und paraview-mcp-server als einzigem Argument:

{
  "mcpServers": {
    "paraview": {
      "command": "uvx",
      "args": ["paraview-mcp-server"]
    }
  }
}

Konsultieren Sie die Dokumentation Ihres Clients für den Speicherort und das genaue Format seiner MCP-Server-Konfiguration.

Konfiguration

Der Server verbindet sich mit dem ParaView-Plugin über diese Umgebungsvariablen:

Die Standardwerte funktionieren für ein normales lokales Setup. Überschreiben Sie diese, wenn Sie eine Verbindung zu ParaView auf einem entfernten Rechner oder einem nicht standardmäßigen Port herstellen:

{
  "mcpServers": {
    "paraview": {
      "command": "uvx",
      "args": ["paraview-mcp-server"],
      "env": {
        "PARAVIEW_HOST": "192.168.1.10",
        "PARAVIEW_PORT": "9877",
        "PARAVIEW_AUTH_TOKEN": "your-token"
      }
    }
  }
}

Verfügbare Tools

Design und Unterschiede zu ParaView_MCP

Dieses Projekt folgt dem Ansatz von Blender-MCP und Slicer-MCP, die beide LLMs die direkte Codeausführung innerhalb ihrer jeweiligen Anwendungslaufzeiten ermöglichen.

Die bestehende ParaView_MCP-Implementierung¹ verfolgt einen anderen Ansatz, indem sie einen festen Satz von High-Level-Tools ohne Zugriff auf die zugrunde liegende Python-Laufzeit bereitstellt, was die Flexibilität für benutzerdefinierte Workflows einschränkt. Die wesentlichen Unterschiede sind:

1. Wir stellen ein execute_paraview_code-Tool zur Verfügung, das beliebigen Python-Code innerhalb der ParaView-Sitzung ausführt. Das Plugin zeichnet jede Ausführung auf und ermöglicht es dem Benutzer, wenn ParaView eine Pipeline-Momentaufnahme erfassen kann, den Zustand unmittelbar vor dieser Ausführung wiederherzustellen. Dies macht generierte Skripte leichter überprüfbar, wiederverwendbar und anpassbar für Aufgaben wie die Stapelverarbeitung.

2. Architektonisch stellt ParaView_MCPs eigener Haftungsausschluss fest, dass es auf der Synchronisation zwischen pvserver und dem ParaView-Client beruht. Dieser Synchronisationsmechanismus ist in neueren ParaView-Versionen veraltet und kann zu falschen Anwendungsansichten und allgemeinen Stabilitätsproblemen führen. Dieses Projekt führt stattdessen ein Plugin innerhalb des interaktiven ParaView-Prozesses aus und stellt eine TCP-Brücke bereit, wodurch der pvserver/Client-Synchronisationspfad vollständig vermieden wird.

Mitwirken

Siehe CONTRIBUTING.md für Build-Anweisungen, Entwicklungseinrichtung und Richtlinien für Pull Requests.

Lizenz

MIT — siehe THIRD-PARTY-NOTICES.txt für Abhängigkeitslizenzen.