ParaView MCP

Conecta ParaView con asistentes LLM a través del Model Context Protocol.

El servidor Python está construido con FastMCP 3.x. El soporte para la especificación MCP 2026-07-28 está planificado una vez que FastMCP 4 alcance una versión estable.

paraview-mcp-server tiene dos partes en tiempo de ejecución:

• un plugin de ParaView (C++/Qt) que expone un puente TCP dentro de la interfaz gráfica de ParaView

• un servidor MCP en Python que se conecta al plugin y proporciona herramientas a cualquier cliente MCP

Requisitos previos

• ParaView ≥ 5.13. Hay plugins precompilados disponibles para las versiones y plataformas exactas que se indican a continuación; otras versiones de ParaView requieren una compilación desde el código fuente contra el SDK correspondiente.

• uv

Related MCP server: MCP-Slicer

Inicio rápido

Primero configura el plugin de ParaView. Luego añade el servidor MCP Python a Claude Code con un solo comando:

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

Abre Herramientas > ParaView MCP en ParaView, inicia el puente y conéctate desde Claude Code.

Configurar el Plugin de ParaView

Descarga un binario del plugin precompilado desde la última versión de GitHub. Las versiones proporcionan esta matriz:

Elige el paquete que coincida con tu versión exacta de ParaView y plataforma. Descarga su archivo .sha256 adyacente, verifica el paquete, luego ábrelo o extráelo y sigue las instrucciones del archivo INSTALL.md incluido. Las solicitudes de extracción también producen binarios de plataforma correspondientes como artefactos de GitHub Actions de corta duración; las versiones de GitHub Releases son el canal de distribución permanente.

Las imágenes de versión para macOS están firmadas con Developer ID, notarizadas por Apple e incluyen un ticket de notarización adherido. Abre el .dmg, copia el directorio del plugin contenido a una ubicación persistente y carga ParaViewMCP.so desde ese directorio copiado. Los artefactos de solicitudes de extracción son compilaciones de prueba sin firmar y permanecen como archivos .tar.gz.

Alternativamente, compila el plugin desde el código fuente contra un SDK de ParaView 5.13 o superior. Consulta CONTRIBUTING.md para obtener instrucciones completas de compilación. La compatibilidad binaria es específica de la serie de versiones, por lo que debes usar un plugin compilado para tu versión mayor.menor de ParaView.

Una vez instalado:

1. Abre Herramientas > Gestionar plugins en ParaView.

2. Haz clic en Cargar nuevo... y selecciona ParaViewMCP.so (Linux/macOS) o ParaViewMCP.dll (Windows) desde el directorio del plugin.

3. Activa Carga automática.

4. Abre Herramientas > ParaView MCP.

5. Haz clic en Iniciar servidor.

El panel de ParaView MCP muestra el estado de la conexión y el historial de ejecución. Los enlaces que no sean de bucle local requieren un token de autenticación.

Configurar tu Cliente MCP

Claude Code (CLI)

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

Claude Desktop

Añade a tu claude_desktop_config.json:

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

Otros Clientes MCP

Configura un servidor MCP stdio local con uvx como comando y paraview-mcp-server como su único argumento:

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

Consulta la documentación de tu cliente para conocer la ubicación y el formato exacto de su configuración de servidor MCP.

Configuración

El servidor se conecta al plugin de ParaView usando estas variables de entorno:

Los valores predeterminados funcionan para una configuración local estándar. Sobrescribe estos valores al conectarte a ParaView en una máquina remota o un puerto no estándar:

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

Herramientas Disponibles

Diseño y Diferencias con ParaView_MCP

Este proyecto sigue el enfoque de Blender-MCP y Slicer-MCP, ambos que otorgan a los LLM la capacidad de ejecutar código directamente dentro de sus respectivos entornos de ejecución de aplicaciones.

La implementación existente de ParaView_MCP¹ adopta un enfoque diferente, exponiendo un conjunto fijo de herramientas de alto nivel sin acceso al entorno de ejecución Python subyacente, lo que limita la flexibilidad para flujos de trabajo personalizados. Las principales diferencias son:

1. Proporcionamos una herramienta execute_paraview_code que ejecuta código Python arbitrario dentro de la sesión de ParaView. El plugin registra cada ejecución y, cuando ParaView puede capturar una instantánea del pipeline, permite al usuario restaurar el estado inmediatamente anterior a esa ejecución. Esto hace que los scripts generados sean más fáciles de inspeccionar, reutilizar y adaptar para tareas como el procesamiento por lotes.

2. Arquitectónicamente, la propia advertencia de ParaView_MCP indica que depende de la sincronización entre pvserver y el cliente de ParaView. Ese mecanismo de sincronización está obsoleto en versiones recientes de ParaView y puede causar vistas de aplicación incorrectas y problemas generales de estabilidad. Este proyecto, en cambio, ejecuta un plugin dentro del proceso interactivo de ParaView y expone un puente TCP, evitando por completo la ruta de sincronización pvserver/cliente.

Contribuciones

Consulta CONTRIBUTING.md para obtener instrucciones de compilación, configuración de desarrollo y pautas para solicitudes de extracción.

Licencia

MIT — consulta THIRD-PARTY-NOTICES.txt para las licencias de dependencias.