🚀 DICOM MCP 服务器
DICOM MCP 服务器是一个用于 DICOM 连接测试的模型上下文协议（MCP）服务器，能帮助用户高效完成 DICOM 相关操作。
🚀 快速开始
在使用 DICOM MCP 服务器之前，需要完成一些准备工作。首先要安装 UV，它是服务器正常运行的必要依赖。安装完成后，可选择传统安装或 MCP 安装两种方式设置服务器。安装完成后，即可运行服务器进行 DICOM 操作。
✨ 主要特性
- 提供两种安装方式，满足不同用户需求。
- 支持直接执行和通过 Claude 管理服务器运行。
- 使用
nodes.yaml文件存储 DICOM 节点配置，方便管理和操作。 - 提供多种 DICOM 工具，可通过 MCP 接口使用。
📦 安装指南
先决条件
安装 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 节点的配置。以下是 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 标题"
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")
🔧 技术细节
节点配置说明
服务器使用 nodes.yaml 文件来存储 DICOM 节点的配置，这使您可以：
- 列出所有已配置的 DICOM 节点。
- 使用节点名称而不是明确的 AE 标题、IP 和端口执行 C-ECHO 操作。
- 为 C-ECHO 操作使用不同的本地 AE 标题。
故障排除
如果您遇到“spawn uv ENOENT”错误，通常意味着以下几种情况之一：
- UV 未安装或不在系统 PATH 中。
- Python 可执行文件无法被 MCP 客户端找到。
解决方案
- 确保 UV 已正确安装并添加到 PATH：
which uv # 应该显示 UV 的路径
-
确保使用可访问系统的 Python 环境：
- 如果使用虚拟环境，请确保已激活。
- 检查 Python 是否在您的 PATH 中。
-
尝试使用完整的 UV 路径运行服务器：
/full/path/to/uv run server.py
- 通过检查错误日志中的 stderr 输出进行更多调试。