3D Slicer模型协议集成工具

通过MCP协议连接3D Slicer与模型客户端,实现医学图像处理和场景操作的交互控制。

  • by zhaoyouj
  • Python
  • 本地部署
  • 45 星标
  • 更新于
在 GitHub 查看 zhaoyouj/mcp-slicer

使用说明

MCP切片器-3D切片器模型上下文协议集成

英语 | 简体中文

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

特性

  1. list_nodes:列出和筛选Slicer MRML节点并查看其属性

  2. execute_python_code:在Slicer环境中执行Python代码

  3. capture_screenshot:捕获切片器视图的实时屏幕截图

    • 完整的应用程序窗口(包括模块面板)
    • 单个切片视图(红色/黄色/绿色)
    • 三维渲染视图
    • 通过视觉反馈实现完整的REACT循环

安装

先决条件

  • 3D切片器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桌面集成

转到Claude>设置>开发人员>编辑配置>Claude_desktop_Config.json,以包含以下内容:

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

临床整合

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

用法

检查Claude设置

Make sure you see the corresponding slicer tools added to the Claude Desktop App

打开切片器Web服务器

  1. 打开切片器Web服务器模块,
  2. 确保检查了所需的接口,
  3. 然后启动服务器

例子

-list_nodes

现在切片器场景中有哪些标记节点,列出它们的名称,如果是直线,它们的长度是多少,如果是角度,它们的角度是多少

-执行python代码

在切片器场景中绘制一个8厘米的半透明绿色立方体,标记其顶点,然后在其中绘制一个红色球体。

-capture_screenshot

捕捉切片器的当前状态,为AI提供视觉反馈

使用示例:

  • capture_screenshot() -捕获完整的应用程序窗口
  • capture_screenshot(view_type="slice", view_name="red") -捕获红色切片视图
  • capture_screenshot(view_type="3d", camera_axis="A") -从前部捕捉3D视图

这实现了一个完整的REACT循环,AI可以:

  1. 理由 关于该做什么
  2. 法案 使用 execute_python_code
  3. 观察 结果使用 capture_screenshot

技术细节

利用现有的Slicer Web服务器界面。有关技术细节,请参阅 Slicer web服务器用户指南

限制和安全考虑

  • 这 execute_python_code 该工具允许在3D Slicer中运行任意Python代码,这功能强大但有潜在危险。

    ⚠️ 不建议用于生产。

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

贡献

欢迎投稿!请随时提交拉取请求。

免责声明

这是一个第三方集成项目,不是由3D Slicer团队开发的。