Dicom Mcp

管理官方认证 Python

🚀 DICOM MCP 服务器

DICOM MCP 服务器是一款基于 Model Context Protocol (MCP) 的工具，可与符合 DICOM 标准的医学影像系统进行交互。它支持通过 MCP 协议检索和操作 DICOM 数据，还具备从封装在 DICOM 实例中的 PDF 文档提取文本等实用功能。

🚀 快速开始

启动服务器

uvicorn dicom_mcp.server:app --reload

使用配置文件启动

创建一个配置文件 config.yaml：

DICOM:
AE_Title: My DICOM Server
Port: 11112
Max_Workers: 4
LogLevel: INFO
Query_Retrieve_Capability:
SCP: true
SCU: false
Storage_SCP: true
Query_SCP: true
Retrieve_SCP: true

然后启动服务器：

uvicorn dicom_mcp.server:app --reload --config config.yaml

✨ 主要特性

支持通过 MCP 协议检索和操作 DICOM 数据。
能够从封装在 DICOM 实例中的 PDF 文档提取文本。

📦 安装指南

使用 pip 安装

pip install dicom-mcp

从源码安装

克隆仓库：

git clone https://github.com/yourusername/dicom-mcp.git
cd dicom-mcp

创建虚拟环境并激活：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate

安装依赖：

pip install -e .

💻 使用示例

基础用法

检索 DICOM 数据

搜索患者

patients = client.search_patients()
for patient in patients:
print(f"Patient ID: {patient.PatientID}, Name: {patient.Name}")

搜索研究

studies = client.search_studies(patient_id="12345")
for study in studies:
print(f"Study Instance UID: {study.StudyInstanceUID}, Modality: {study.Modality}")

搜索系列

series = client.search_series(study_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.1")
for series in studies:
print(f"Series Instance UID: {series.SeriesInstanceUID}, Description: {series.SeriesDescription}")

搜索实例

instances = client.search_instances(series_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.2")
for instance in instances:
print(f"SOP Instance UID: {instance.SOPInstanceUID}")

检索特定实例

instance = client.retrieve_instance(
study_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.1",
series_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.2",
sop_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.3"
)
print(instance.PixelData)

封装 PDF 文本提取

text = client.extract_pdf_text(
study_instance_uid="1.2.840.10008.5.1.4.1.1.104.1.1",
series_instance_uid="1.2.840.10008.5.1.4.1.1.104.1.2",
sop_instance_uid="1.2.840.10008.5.1.4.1.1.104.1.3"
)
print(text)

📚 详细文档

配置

默认配置文件

DICOM:
AE_Title: My DICOM Server
Port: 11112
Max_Workers: 4
LogLevel: INFO
Query_Retrieve_Capability:
SCP: true
SCU: false
Storage_SCP: true
Query_SCP: true
Retrieve_SCP: true

自定义配置

创建一个自定义配置文件 config.yaml：

DICOM:
AE_Title: My Custom DICOM Server
Port: 11113
Max_Workers: 8
LogLevel: DEBUG
Query_Retrieve_Capability:
SCP: false
SCU: true
Storage_SCP: false
Query_SCP: false
Retrieve_SCP: true