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:
  # 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 未安装或不在您的 PATH 中
2. MCP 客户端找不到 Python 可执行文件

解决方案：

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

   which uv  # 应显示 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")