ParaView MCP

Подключите ParaView к LLM-ассистентам через Model Context Protocol.

Python-сервер построен на FastMCP 3.x. Поддержка спецификации MCP 2026-07-28 запланирована после выхода стабильной версии FastMCP 4.

paraview-mcp-server состоит из двух частей времени выполнения:

• плагин ParaView (C++/Qt), который предоставляет TCP-мост внутри GUI ParaView

• Python MCP-сервер, который подключается к плагину и предоставляет инструменты любому MCP-клиенту

Предварительные требования

• ParaView ≥ 5.13. Предварительно собранные плагины доступны для точных версий и платформ, указанных ниже; для других выпусков ParaView требуется сборка из исходного кода с соответствующим SDK.

• uv

Related MCP server: MCP-Slicer

Быстрый старт

Сначала настройте плагин ParaView. Затем добавьте Python MCP-сервер в Claude Code одной командой:

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

Откройте Инструменты > ParaView MCP в ParaView, запустите мост и подключитесь из Claude Code.

Настройка плагина ParaView

Загрузите предварительно собранный бинарный файл плагина из последнего релиза на GitHub. Релизы предоставляют следующую матрицу:

Выберите пакет, соответствующий вашей точной версии ParaView и платформе. Загрузите прилегающий файл .sha256, проверьте пакет, затем откройте или распакуйте его и следуйте инструкциям в прилагаемом INSTALL.md. Pull request'ы также создают соответствующие бинарные файлы платформы в виде кратковременных артефактов GitHub Actions; GitHub Releases являются постоянным каналом распространения.

Образы релизов для macOS подписаны Developer ID, нотаризованы Apple и содержат прикрепленный нотаризационный билет. Откройте .dmg, скопируйте содержащуюся директорию плагина в постоянное место и загрузите ParaViewMCP.so из этой скопированной директории. Артефакты pull request'ов являются неподписанными тестовыми сборками и остаются файлами .tar.gz.

В качестве альтернативы соберите плагин из исходного кода с использованием SDK ParaView 5.13 или новее. Полные инструкции по сборке см. в CONTRIBUTING.md. Двоичная совместимость специфична для серии релизов, поэтому используйте плагин, собранный для вашей версии major.minor ParaView.

После установки:

1. Откройте Инструменты > Управление плагинами в ParaView.

2. Нажмите Загрузить новый... и выберите ParaViewMCP.so (Linux/macOS) или ParaViewMCP.dll (Windows) из директории плагина.

3. Включите Автозагрузка.

4. Откройте Инструменты > ParaView MCP.

5. Нажмите Запустить сервер.

Панель ParaView MCP отображает статус подключения и историю выполнения. Для привязок не к локальной петле требуется токен аутентификации.

Настройка MCP-клиента

Claude Code (CLI)

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

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

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

Другие MCP-клиенты

Настройте локальный stdio MCP-сервер с uvx в качестве команды и paraview-mcp-server в качестве единственного аргумента:

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

Обратитесь к документации вашего клиента за расположением и точным форматом конфигурации его MCP-сервера.

Конфигурация

Сервер подключается к плагину ParaView, используя следующие переменные окружения:

Значения по умолчанию подходят для стандартной локальной настройки. Переопределите их при подключении к ParaView на удаленной машине или нестандартном порту:

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

Доступные инструменты

Дизайн и отличия от ParaView_MCP

Этот проект следует подходу Blender-MCP и Slicer-MCP, оба из которых предоставляют LLM прямой доступ к выполнению кода внутри соответствующих сред выполнения приложений.

Существующая реализация ParaView_MCP¹ использует другой подход, предоставляя фиксированный набор высокоуровневых инструментов без доступа к базовой среде выполнения Python, что ограничивает гибкость для пользовательских рабочих процессов. Основные различия:

1. Мы предоставляем инструмент execute_paraview_code, который выполняет произвольный Python внутри сеанса ParaView. Плагин записывает каждое выполнение и, когда ParaView может захватить снимок пайплайна, позволяет пользователю восстановить состояние непосредственно перед этим выполнением. Это делает сгенерированные скрипты более удобными для проверки, повторного использования и адаптации для таких задач, как пакетная обработка.

2. Архитектурно, собственное предупреждение ParaView_MCP утверждает, что он полагается на синхронизацию между pvserver и клиентом ParaView. Этот механизм синхронизации устарел в последних версиях ParaView и может вызывать некорректные представления приложения и общие проблемы со стабильностью. Вместо этого данный проект запускает плагин внутри интерактивного процесса ParaView и предоставляет TCP-мост, полностью избегая пути синхронизации pvserver/клиент.

Участие в разработке

Инструкции по сборке, настройке среды разработки и рекомендации по pull request'ам см. в CONTRIBUTING.md.

Лицензия

MIT — информацию о лицензиях зависимостей см. в THIRD-PARTY-NOTICES.txt.