MCP-Slicer

MCP-Slicer - Integração do 3D Slicer com o Model Context Protocol

English | 简体中文

O MCP-Slicer conecta o 3D Slicer a clientes de modelo como Claude Desktop ou Cline por meio do Model Context Protocol (MCP), permitindo interação direta e controle do 3D Slicer. Essa integração possibilita processamento de imagens médicas, criação de cenas e manipulação usando linguagem natural.

Recursos

1. list_nodes: Listar e filtrar nós MRML do Slicer e visualizar suas propriedades

2. execute_python_code: Executar código Python no ambiente do Slicer

3. capture_screenshot: Capturar capturas de tela em tempo real das visualizações do Slicer

   • Janela completa do aplicativo (incluindo painéis de módulos)
   • Visualizações de fatia individuais (Vermelho/Amarelo/Verde)
   • Visualização de renderização 3D
   • Permite ciclo REACT completo com feedback visual

Instalação

Pré-requisitos

• 3D Slicer 5.8 ou mais recente
• Python 3.13 ou mais recente
• Gerenciador de pacotes uv

Se você estiver no Mac, instale o uv da seguinte forma

brew install uv

No Windows

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

e depois

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

Caso contrário, as instruções de instalação estão no site deles: Instalar uv

⚠️ Instale o UV primeiro

Integração com Claude for Desktop

Vá para Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir o seguinte:

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

Integração com Cline

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

Uso

Verificar Configurações do Claude

Certifique-se de ver as ferramentas do slicer correspondentes adicionadas ao Claude Desktop App

Abrir o Slicer Web Server

1. Abra o módulo Slicer Web Server,
2. certifique-se de que as interfaces necessárias estejam marcadas,
3. e então inicie o servidor

Exemplos

- list_nodes

Quais nós de Markups estão na cena do Slicer agora, liste seus nomes, qual é o comprimento se for uma linha, e qual é o ângulo se for um ângulo

- execute python code

Desenhe um cubo verde translúcido de 8 cm na cena do Slicer, marque seus vértices e, em seguida, desenhe uma esfera vermelha inscrita nele.

- capture_screenshot

Capture o estado atual do Slicer para fornecer feedback visual à IA

Exemplos de uso:

• capture_screenshot() - Capturar a janela completa do aplicativo
• capture_screenshot(view_type="slice", view_name="red") - Capturar a visualização da fatia Vermelha
• capture_screenshot(view_type="3d", camera_axis="A") - Capturar a visualização 3D a partir da anterior

Isso permite um ciclo REACT completo onde a IA pode:

1. Raciocinar sobre o que fazer
2. Agir usando execute_python_code
3. Observar o resultado usando capture_screenshot

Detalhes Técnicos

Utiliza as interfaces existentes do Slicer Web Server. Para detalhes técnicos, consulte o guia do usuário do Slicer web server

Limitações e Considerações de Segurança

• A ferramenta execute_python_code permite executar código Python arbitrário no 3D Slicer, o que é poderoso, mas potencialmente perigoso.

  ⚠️ Não recomendado para uso em produção.

• Operações complexas podem precisar ser divididas em etapas menores.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar Pull Requests.

Aviso Legal

Este é um projeto de integração de terceiros, não desenvolvido pela equipe do 3D Slicer.