Dicom MCP

🚀 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

從源碼安裝

1. 克隆倉庫：

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

2. 創建虛擬環境並激活：

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

3. 安裝依賴：

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

然後啟動服務器：

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

開發

克隆倉庫

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

安裝依賴

pip install -r requirements.txt

啟動開發服務器

uvicorn dicom_mcp.server:app --reload

貢獻

1. Fork 倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到分支。
5. 創建拉取請求。

📄 許可證

本項目使用 MIT 許可證。