DICOM MCP 服务器

一个用于 DICOM 连通性测试的 Model Context Protocol (MCP) 服务器。

先决条件

1. 安装 UV（必需）：

   pip install uv
   

   确保 uv 已经安装在您的系统 PATH 中，因为它对 Claude 正确运行服务器至关重要。

安装

有两种方式可以设置服务器：

1. 传统安装

安装所需的依赖项：

uv pip install mcp[cli]

2. MCP 安装（推荐）

要使用此服务器与 Claude 的 Model Context Protocol 一起使用：

mcp install server.py

这将自动在 Claude 中注册服务器以进行 DICOM 操作。

运行服务器

直接执行

uv run server.py

通过 Claude

一旦通过 MCP 安装，Claude 将会根据需要自动管理该服务器。

服务器将默认运行在 0.0.0.0:8080 端口。

节点配置

服务器使用一个 nodes.yaml 文件来存储 DICOM 节点的配置信息。这使您可以：

1. 列出所有已配置的 DICOM 节点
2. 使用节点名称而不是显式的 AE 标题、IP 和端口进行 C-ECHO 操作
3. 为 C-ECHO 操作使用不同的本地 AE 标题

nodes.yaml 文件格式

nodes:
  # 示例节点配置
  main_pacs:
    ae_title: DESTINATION
    ip: 192.168.1.100
    port: 104
    description: "主要医院 PACS 系统"

local_ae_titles:
  - name: default
    ae_title: MCP_DICOM
    description: "MCP DICOM 服务器默认 AE 标题"
  
  - name: pacs_gateway
    ae_title: PACS_GATEWAY
    description: "PACS网关 AE 标题"

故障排除

如果遇到“spawn uv ENOENT”错误，通常意味着以下原因之一：

1. UV 未安装或不在系统 PATH 中
2. Python 可执行文件无法被 MCP 客户端找到

解决方法：

1. 确保 UV 已经正确安装并在 PATH 中：

   which uv  # 应该显示 UV 的路径
   

2. 确保使用的是可访问的 Python 环境：

   • 如果使用虚拟环境，请确保已激活
   • 检查 Python 是否在 PATH 中

3. 尝试通过指定 UV 的完整路径运行服务器：

   /full/path/to/uv run server.py
   

4. 通过检查日志中的 stderr 输出添加更多调试信息

使用说明

该服务器提供了几种可通过 MCP 接口使用的 DICOM 工具：

列出 DICOM 节点

列出配置文件中所有已配置的 DICOM 节点：

list_dicom_nodes()

通过节点名称进行 C-ECHO

使用配置中的节点名称执行 C-ECHO 操作：

dicom_cecho_by_name(node_name="main_pacs", local_ae_name="default")

直接进行 C-ECHO

使用显式参数执行 C-ECHO 操作：

dicom_cecho(remote_ae_title="REMOTE_AE", ip="192.168.1.100", port=104, local_ae_title="MCP_DICOM")