MCP-Slicer - 3D Slicer 模型上下文协议集成

English | 简体中文

MCP-Slicer 通过模型上下文协议（MCP）将 3D Slicer 与 Claude Desktop 或 Cline 等模型客户端连接起来，实现了对 3D Slicer 的直接交互和控制。这一集成允许使用自然语言进行医学图像处理、场景创建和操作。

功能

1. list_nodes: 列出并筛选 Slicer MRML 节点，并查看它们的属性
2. execute_python_code: 在 Slicer 环境中执行 Python 代码

安装

前提条件

• 3D Slicer 5.8 或更新版本
• Python 3.13 或更新版本
• uv 包管理器

如果你使用的是 Mac，请按以下方式安装 uv：

brew install uv

在 Windows 上

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

然后

set Path=C:\Users\nntra\.local\bin;%Path%

更多安装说明请访问其官方网站：安装 uv

⚠️ 请先安装 UV

Claude for Desktop 集成

前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，添加以下内容：

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

Cline 集成

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

使用方法

检查 Claude 设置

打开 Slicer Web 服务器

1. 打开 Slicer Web 服务器模块，
2. 确保所需接口已被选中，
3. 然后启动服务器

示例

- list_nodes

当前 Slicer 场景中的标记节点有哪些？列出它们的名称，如果是线，则列出其长度；如果是角度，则列出其角度。

- 执行 Python 代码

在 Slicer 场景中绘制一个半透明的 8 厘米绿色立方体，标记其顶点，然后在其内部绘制一个红色球体。

技术细节

利用现有的 Slicer Web 服务器接口。有关技术细节，请参阅 Slicer web 服务器用户指南

限制与安全考虑

• execute_python_code 工具允许在3D Slicer中运行任意Python代码，这很强大但同时也可能带来危险。

  ⚠️ 不建议用于生产环境。

• 复杂的操作可能需要被分解成更小的步骤。

贡献

欢迎贡献！请随时提交Pull Requests。

免责声明

这是一个第三方集成项目，并非由3D Slicer团队开发。