dicom-mcp: A DICOM Model Context Protocol Server

dicom-mcp: A DICOM Model Context Protocol Server

site icon
2025.04.15 23
Python医学影像服务医疗数据分析其它
dicom-mcp 是一个基于 DICOM(医学数字成像和通信)模型的上下文协议服务器,专门设计用于与 DICOM 服务器进行交互。它使大型语言模型能够访问和分析医学影像元数据,支持查询患者信息、研究、系列和实例,并能从 DICOM 格式的封装 PDF 文档中提取文本内容。该服务器基于 pynetdicom 构建,并遵循模型上下文协议规范。
View on GitHub

Overview

基本能力

产品定位

dicom-mcp 是一个专门用于医学影像数据交互的服务器,旨在为 AI 助手提供访问和分析 DICOM 数据的能力。

核心功能

  • 查询和交互 DICOM 服务器
  • 支持患者信息、研究、系列和实例的查询
  • 从 DICOM 格式的封装 PDF 文档中提取文本内容
  • 支持 DICOM 网络协议

适用场景

  • 医学影像数据分析
  • 临床报告自动化处理
  • AI 辅助医疗诊断

工具列表

  1. list_dicom_nodes: 列出所有配置的 DICOM 节点和调用 AE 标题
  2. switch_dicom_node: 切换到不同的配置 DICOM 节点
  3. switch_calling_aet: 切换到不同的调用 AE 标题
  4. verify_connection: 测试与配置 DICOM 节点的连接
  5. query_patients: 根据条件搜索患者
  6. query_studies: 根据条件搜索研究
  7. query_series: 在研究内搜索系列
  8. query_instances: 在系列内搜索实例
  9. get_attribute_presets: 列出查询可用的属性预设
  10. retrieve_instance: 检索特定 DICOM 实例并保存到本地文件系统
  11. extract_pdf_text_from_dicom: 从 DICOM 封装的 PDF 中提取文本内容

常见问题解答

  • 需要配置 YAML 文件来定义 DICOM 节点和调用 AE 标题
  • 需要 Python 3.12 或更高版本
  • 需要连接到 DICOM 服务器(如 Orthanc、dcm4chee 等)

使用教程

使用依赖

  • Python 3.12 或更高版本
  • DICOM 服务器(如 Orthanc、dcm4chee 等)

安装教程

pip install dicom-mcp

配置

创建一个 YAML 配置文件,定义 DICOM 节点和调用 AE 标题。

运行服务器

dicom-mcp /path/to/configuration.yaml

或使用 uv:

uv run dicom-mcp /path/to/configuration.yaml

调试方式

使用 MCP 检查器调试服务器:

npx @modelcontextprotocol/inspector uv --directory /path/to/dicom-mcp run dicom-mcp /path/to/configuration.yaml

许可证

该项目遵循 MIT 开源许可条款。