zhaoyouj/mcp-slicer

English | 简体中文
MCP-Slicer connects 3D Slicer with model clients like Claude Desktop or Cline through the Model Context Protocol (MCP), enabling direct interaction and control of 3D Slicer. This integration allows for medical image processing, scene creation, and manipulation using natural language.
## Features
1. listnodes: List and filter Slicer MRML nodes and view their properties
2. executepythoncode: Execute Python code in the Slicer environment
3. capturescreenshot: Capture real-time screenshots of Slicer views
Full application window (including module panels)
Individual slice views (Red/Yellow/Green)
3D rendering view
Enables complete REACT loop with visual feedback
## Installation
### Prerequisites
3D Slicer 5.8 or newer
Python 3.13 or newer
uv package manager
If you're on Mac, please install uv as
bash
brew install uv
On Windows
bash
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
and then
bash
set Path=C:\Users\nntra\.local\bin;%Path%
Otherwise installation instructions are on their website: Install uv
⚠️ Please install UV first
### Claude for Desktop Integration
Go to Claude > Settings > Developer > Edit Config > claudedesktopconfig.json to include the following:
json
"mcpServers": {
"slicer": {
"command": "uvx",
"args": ["mcp-slicer"]
### Cline Intergration
json
"mcpServers": {
"slicer": {
"command": "uvx",
"args": ["mcp-slicer"]
## Usage
### Check Claude Settings
Make sure you see the corresponding slicer tools added to the Claude Desktop App
### Open Slicer Web Server
1. Open the Slicer Web Server module,
2. ensure the required interfaces are checked,
3. then start the server
## Examples
### - listnodes
> What Markups nodes are in the Slicer scene now, list their names, what is their length if it is a line, and what is its angle if it is an angle
### - execute python code
> Draw a translucent green cube of 8 cm in the Slicer scene, mark its vertices, and then draw a red sphere inscribed in it.
### - capturescreenshot
> Capture the current state of Slicer to provide visual feedback to AI
Usage examples:
capturescreenshot() - Capture full application window
capturescreenshot(viewtype="slice", viewname="red") - Capture Red slice view
capturescreenshot(viewtype="3d", cameraaxis="A") - Capture 3D view from anterior
This enables a complete REACT loop where AI can:
1. Reason about what to do
2. Act using executepythoncode
3. Observe the result using capturescreenshot