ParaView MCP

通过模型上下文协议将ParaView连接到LLM助手。

Python服务器使用FastMCP 3.x构建。对2026-07-28 MCP规范的支持计划在FastMCP 4稳定版发布后实现。

paraview-mcp-server包含两个运行时部分：

• 一个ParaView插件（C++/Qt），在ParaView GUI内部暴露一个TCP桥接

• 一个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中打开工具 > ParaView MCP，启动桥接，然后从Claude Code连接。

设置ParaView插件

从最新的GitHub Release下载预构建的插件二进制文件。Release提供以下矩阵：

选择与您的精确ParaView版本和平台匹配的包。下载其旁边的.sha256文件，验证包，然后打开或解压并按照随附的INSTALL.md操作。拉取请求也会生成相应的平台二进制文件，作为短期GitHub Actions工件；GitHub Releases是永久分发渠道。

macOS发布镜像已进行开发者ID签名，经Apple公证，并包含已钉章的公证票据。打开.dmg，将包含的插件目录复制到持久位置，然后从该复制目录加载ParaViewMCP.so。拉取请求工件是未签名的测试构建，仍为.tar.gz文件。

或者，针对ParaView 5.13或更新的SDK从源码构建插件。有关完整构建说明，请参阅CONTRIBUTING.md。二进制兼容性因发布系列而异，因此请使用为您的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工具，可以在ParaView会话中运行任意Python代码。插件记录每次执行，并在ParaView可以捕获管道快照时，允许用户恢复紧接该执行之前的状态。这使得生成的脚本更易于检查、重用和适应批处理等任务。

2. 架构上，ParaView_MCP自身的免责声明指出，它依赖于pvserver与ParaView客户端之间的同步。该同步机制在较新的ParaView版本中已被弃用，可能导致错误的应用程序视图和一般稳定性问题。本项目改为在交互式ParaView进程内运行一个插件，并暴露一个TCP桥接，完全避免了pvserver/客户端同步路径。

贡献

请参阅CONTRIBUTING.md了解构建说明、开发设置和拉取请求指南。

许可证

MIT — 依赖项许可证请参见THIRD-PARTY-NOTICES.txt。