使用说明

项目简介

PyVista MCP 服务器是一个基于 Model Context Protocol (MCP) 标准构建的后端服务。它集成了强大的 PyVista 库，使得大型语言模型 (LLM) 客户端可以通过调用定义的工具，方便地执行 3D 渲染和可视化任务。该服务器通过标准协议与兼容的 MCP 客户端通信，响应来自 LLM 的请求。

主要功能点

3D 可视化工具: 提供了 'hello_world' 工具。该工具能够利用 PyVista 创建一个包含多种基础 3D 几何体（如圆柱、箭头、球体等）的复杂场景。
交互式导出: 'hello_world' 工具执行后，会将生成的 3D 场景导出为一个独立的 HTML 文件。这个 HTML 文件可以在任何现代浏览器中打开，并支持用户进行旋转、缩放等交互操作，无需额外的软件或插件。

安装步骤

要运行此 MCP 服务器，您需要安装 Python 及其所需的依赖库。

确保您已安装 Python (建议使用 Python 3.8+)。

安装必要的 Python 库，包括 'pyvista' 和 'mcp' (请注意，'mcp' 库可能需要从特定源获取或安装)。

# 假设项目结构和名称，请根据实际情况调整
# 如果代码在一个可安装的包结构中
# pip install .
# 或者如果只是直接运行脚本
# pip install pyvista mcp

请查阅 PyVista 和 MCP 相关文档获取更详细的安装指南。

服务器配置

MCP 服务器通常由 MCP 客户端（如一个 LLM 代理应用）启动和管理。客户端需要一个配置来了解如何启动并连接到该服务器。以下是配置此 PyVista MCP 服务器的示例 JSON 结构及其说明：

mcpServers: 包含一个或多个 MCP 服务器配置的对象。
- mcp-demo-server: 您为该服务器实例定义的名称，可自定义。
  - disabled: 布尔值，'true' 表示禁用此服务器，'false' 表示启用。
  - timeout: 数字，服务器启动或响应的超时时间（秒）。
  - command: 字符串，用于启动服务器的可执行命令路径。通常是 Python 解释器的路径，例如 '/usr/local/bin/python'。
  - args: 字符串数组，传递给命令的参数。对于此服务器，通常是 '-m pyvista_mcp_server' 或指向主脚本的路径。
  - transportType: 字符串，服务器使用的传输协议。此示例中为 'stdio'，表示通过标准输入输出进行通信。

基本使用方法

在 MCP 客户端配置并成功启动该服务器后，LLM 可以通过标准 MCP 协议调用服务器提供的工具。

启动服务器: MCP 客户端根据配置（如 'command' 和 'args'）启动服务器进程。如果手动测试，可以在终端运行：
```
python -m pyvista_mcp_server
```
服务器将通过 Stdio 监听 MCP 请求。
调用工具: LLM 客户端通过发送 MCP JSON-RPC 请求来调用 'hello_world' 工具。
获取结果: 服务器执行 'hello_world' 工具，生成 3D 场景并导出为 'a_basic.html' 文件。工具的返回值（如 HTML 文件路径）会通过 JSON-RPC 响应返回给客户端。
查看可视化: 客户端或用户可以打开服务器指定目录下生成的 'a_basic.html' 文件，在浏览器中查看交互式 3D 可视化结果。

关键词