3D Slicer

🚀 MCP-Slicer - 3D Slicer 模型上下文協議整合

MCP-Slicer 能夠將 3D Slicer 與模型客戶端（例如 Claude Desktop 或者 Cline）藉助模型上下文協議（MCP）連接起來，從而實現對 3D Slicer 的直接交互與控制。通過這種集成，利用自然語言進行醫學圖像處理、場景創建和操作成為可能。

🚀 快速開始

MCP-Slicer 可實現 3D Slicer 與模型客戶端的連接，讓你能使用自然語言對 3D Slicer 進行操作。下面為你介紹使用前的安裝和配置步驟。

✨ 主要特性

• list_nodes：列出並篩選 3D Slicer 中的 MRML 節點及其屬性。
• execute_python_code：在 3D Slicer 環境中執行 Python 代碼。

📦 安裝指南

先決條件

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

如果你使用的是 Mac，請按照以下命令安裝 uv：

brew install uv

對於 Windows 用戶，運行以下 PowerShell 命令：

irm https://astral.sh/uv/install.ps1 | iex

然後執行：

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

否則，請參考其官方網站上的安裝說明：安裝 uv

⚠️ 重要提示

請先安裝 UV

Claude Desktop 集成

進入 Claude > 設置 > 開發者 > 編輯配置 > claude_desktop_config.json，添加以下內容：

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

Cline 集成

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

💻 使用示例

基礎用法

檢查 Claude 設置

請確保在 Claude Desktop 應用中看到相應的 slicer 工具已添加。

啟動 Slicer Web 服務器

1. 打開 Slicer Web Server 模塊。
2. 確保選擇了所需的接口。
3. 然後啟動服務器。

高級用法

- list_nodes

當前 Slicer 場景中有哪些 Markups 節點？請列出它們的屬性。

- execute_python_code

請運行以下 Python 代碼以計算 3D 模型的體積：

import numpy as np
from stl import mesh

# 加載 STL 文件
model = mesh.Mesh.from_file("model.stl")
points = model.vectors.reshape(-1, 3)

# 計算體積
volume = np.abs(np.dot(points[0], np.cross(points[1], points[2]))) / 6.0
print(f"模型的體積為: {volume}")

📚 詳細文檔

此項目是一個第三方集成項目，非 3D Slicer 團隊開發。

英文版 | 繁體中文版

如果需要進一步的幫助或信息，請參考原始英文文檔。