mcp-slicer


Namemcp-slicer JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummaryA MCP server for 3D Slicer
upload_time2025-03-21 11:43:45
maintainerNone
docs_urlNone
authorNone
requires_python>=3.13
licenseNone
keywords 3d slicer mcp medical imaging
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <img src="docs/images/logo.jpeg" width="160" alt="logo">

# MCP-Slicer - 3D Slicer Model Context Protocol Integration

[![Python Version](https://img.shields.io/badge/python-3.13%2B-blue.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://img.shields.io/pypi/v/mcp-slicer.svg)](https://pypi.org/project/mcp-slicer/)

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

## Features

1. list_nodes: 用于列出和过滤 Slicer MRML 节点并查看其属性

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

## Installation

### Prerequisites

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

**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](https://docs.astral.sh/uv/getting-started/installation/)

**⚠️ 请先安装 UV**

### Claude for Desktop Integration

Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

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

### Cline Intergration

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

## Usage

[此处可添加使用说明和示例]

## Technical Details

借助了 Slicer Web Server 现有接口,技术细节请查看 [Slicer web server user guide](https://slicer.readthedocs.io/en/latest/user_guide/modules/webserver.html)

## Limitations & Security Considerations

- `execute_python_code` 工具允许在 3D Slicer 中运行任意 Python 代码,这很强大但也可能存在潜在危险。

  **⚠️ 请勿在生产环境中使用。**

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

## Contributing

欢迎贡献!请随时提交 Pull Request。

## Disclaimer

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

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mcp-slicer",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.13",
    "maintainer_email": null,
    "keywords": "3d slicer, mcp, medical imaging",
    "author": null,
    "author_email": "zhaoyouj <zhaoyouj@outlook.com>",
    "download_url": null,
    "platform": null,
    "description": "<img src=\"docs/images/logo.jpeg\" width=\"160\" alt=\"logo\">\n\n# MCP-Slicer - 3D Slicer Model Context Protocol Integration\n\n[![Python Version](https://img.shields.io/badge/python-3.13%2B-blue.svg)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PyPI version](https://img.shields.io/pypi/v/mcp-slicer.svg)](https://pypi.org/project/mcp-slicer/)\n\nMCP-Slicer \u901a\u8fc7\u6a21\u578b\u4e0a\u4e0b\u6587\u534f\u8bae(MCP)\u5c06 3D Slicer \u4e0e \u4f8b\u5982 Claude Desktop \u6216 Cline \u7b49\u6a21\u578b\u5ba2\u6237\u7aef\u8fde\u63a5\u8d77\u6765\uff0c\u4f7f\u4e4b\u80fd\u591f\u76f4\u63a5\u4e0e 3D Slicer \u4ea4\u4e92\u548c\u63a7\u5236\u3002\u8fd9\u79cd\u96c6\u6210\u5b9e\u73b0\u4e86\u7528\u81ea\u7136\u8bed\u8a00\u8fdb\u884c\u533b\u5b66\u5f71\u50cf\u5904\u7406\u3001\u573a\u666f\u521b\u5efa\u548c\u64cd\u4f5c\u3002\n\n## Features\n\n1. list_nodes: \u7528\u4e8e\u5217\u51fa\u548c\u8fc7\u6ee4 Slicer MRML \u8282\u70b9\u5e76\u67e5\u770b\u5176\u5c5e\u6027\n\n2. execute_python_code: \u5141\u8bb8\u5728 Slicer \u73af\u5883\u4e2d\u6267\u884c Python \u4ee3\u7801\n\n## Installation\n\n### Prerequisites\n\n- 3D Slicer 5.8 \u6216\u66f4\u65b0\u7248\u672c\n- Python 3.13 \u6216\u66f4\u65b0\u7248\u672c\n- uv \u5305\u7ba1\u7406\u5668\n\n**If you're on Mac, please install uv as**\n\n```bash\nbrew install uv\n```\n\n**On Windows**\n\n```bash\npowershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\nand then\n\n```bash\nset Path=C:\\Users\\nntra\\.local\\bin;%Path%\n```\n\nOtherwise installation instructions are on their website: [Install uv](https://docs.astral.sh/uv/getting-started/installation/)\n\n**\u26a0\ufe0f \u8bf7\u5148\u5b89\u88c5 UV**\n\n### Claude for Desktop Integration\n\nGo to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:\n\n```json\n{\n  \"mcpServers\": {\n    \"slicer\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-slicer\"]\n    }\n  }\n}\n```\n\n### Cline Intergration\n\n```json\n{\n  \"mcpServers\": {\n    \"slicer\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-slicer\"]\n    }\n  }\n}\n```\n\n## Usage\n\n[\u6b64\u5904\u53ef\u6dfb\u52a0\u4f7f\u7528\u8bf4\u660e\u548c\u793a\u4f8b]\n\n## Technical Details\n\n\u501f\u52a9\u4e86 Slicer Web Server \u73b0\u6709\u63a5\u53e3\uff0c\u6280\u672f\u7ec6\u8282\u8bf7\u67e5\u770b [Slicer web server user guide](https://slicer.readthedocs.io/en/latest/user_guide/modules/webserver.html)\n\n## Limitations & Security Considerations\n\n- `execute_python_code` \u5de5\u5177\u5141\u8bb8\u5728 3D Slicer \u4e2d\u8fd0\u884c\u4efb\u610f Python \u4ee3\u7801\uff0c\u8fd9\u5f88\u5f3a\u5927\u4f46\u4e5f\u53ef\u80fd\u5b58\u5728\u6f5c\u5728\u5371\u9669\u3002\n\n  **\u26a0\ufe0f \u8bf7\u52ff\u5728\u751f\u4ea7\u73af\u5883\u4e2d\u4f7f\u7528\u3002**\n\n- \u590d\u6742\u64cd\u4f5c\u53ef\u80fd\u9700\u8981\u5206\u89e3\u4e3a\u66f4\u5c0f\u7684\u6b65\u9aa4\u3002\n\n## Contributing\n\n\u6b22\u8fce\u8d21\u732e\uff01\u8bf7\u968f\u65f6\u63d0\u4ea4 Pull Request\u3002\n\n## Disclaimer\n\n\u8fd9\u662f\u4e00\u4e2a\u7b2c\u4e09\u65b9\u96c6\u6210\u9879\u76ee\uff0c\u4e0d\u662f\u7531 3D Slicer \u5b98\u65b9\u5f00\u53d1\u3002\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A MCP server for 3D Slicer",
    "version": "0.1.1",
    "project_urls": {
        "Bug Tracker": "https://github.com/zhaoyouj/mcp-slicer/issues",
        "Documentation": "https://github.com/zhaoyouj/mcp-slicer#readme",
        "Homepage": "https://github.com/zhaoyouj/mcp-slicer",
        "Repository": "https://github.com/zhaoyouj/mcp-slicer.git"
    },
    "split_keywords": [
        "3d slicer",
        " mcp",
        " medical imaging"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "62932351fb62d01d38382d66abb97646c07608ec0233c522f2fc395269ab75ea",
                "md5": "e059620a0dffc2d10c5517f57a15e28c",
                "sha256": "a4ee17ad9bd2d798d9b21c798dd8b9be96a22edc70dcbc810f06d871a91d3dc7"
            },
            "downloads": -1,
            "filename": "mcp_slicer-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e059620a0dffc2d10c5517f57a15e28c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.13",
            "size": 5508,
            "upload_time": "2025-03-21T11:43:45",
            "upload_time_iso_8601": "2025-03-21T11:43:45.207830Z",
            "url": "https://files.pythonhosted.org/packages/62/93/2351fb62d01d38382d66abb97646c07608ec0233c522f2fc395269ab75ea/mcp_slicer-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-03-21 11:43:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "zhaoyouj",
    "github_project": "mcp-slicer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "mcp-slicer"
}
        
Elapsed time: 0.41883s