DICOM MCP Server

DICOM MCP 服务

用于 DICOM 连接测试的模型上下文协议（MCP）服务。

前提条件

1. 安装 UV（必需）：

   pip install uv
   

   确保 uv 位于系统 PATH 中，因为 Claude 需要它才能正确执行该服务。

安装

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

1. 传统设置

安装所需依赖：

uv pip install mcp[cli]

2. MCP 安装（推荐）

若要将此服务与 Claude 的模型上下文协议配合使用：

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:
  # Example node configuration
  main_pacs:
    ae_title: DESTINATION
    ip: 192.168.1.100
    port: 104
    description: "Main hospital PACS system"

local_ae_titles:
  - name: default
    ae_title: MCP_DICOM
    description: "Default AE title for MCP DICOM server"
  
  - name: pacs_gateway
    ae_title: PACS_GATEWAY
    description: "PACS Gateway AE title"

故障排除

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

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

解决方案：

1. 确保已正确安装 UV，且 UV 位于 PATH 中：

   which uv  # Should show the path to UV
   

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

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

3. 尝试使用明确指定的 UV 路径运行服务：

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

4. 检查日志中的 stderr 输出，以获取更多调试信息

用法

该服务提供了多个可通过 MCP 接口使用的 DICOM 工具：

列出 DICOM 节点

列出 nodes.yaml 文件中的所有已配置 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")