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:
  # 示例节点配置
  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. 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")