DICOM

🚀 DicomMcp 簡介

DicomMcp 是一個遵循 Model Context Protocol (MCP) 規範的 DICOM 服務端實現，可用於與模型建立上下文連接。它基於 pynetdicom 開發，還支持 PDF 文本提取功能。

🚀 快速開始

安裝

通過 pip 安裝：

pip install dicom-mcp

配置

創建一個配置文件 config.json，內容如下：

{
  "port": 11112,
  "title": "DicomMcp Server",
  "description": "A DICOM server following the Model Context Protocol"
}

初始化服務

在 Python 腳本中初始化 DicomMcp 服務：

from dicom_mcp import DicomMcpServer

# 創建配置文件
config = {
    "port": 11112,
    "title": "DicomMcp Server",
    "description": "A DICOM server following the Model Context Protocol"
}

# 初始化服務
server = DicomMcpServer(config)

# 啟動服務
server.start()

使用命令行啟動

通過命令行運行：

python -m dicom_mcp.run --config config.json

✨ 主要特性

• 遵循 MCP 協議
• 支持 DICOM 標準
• 提供配置管理
• 包含測試用例
• 使用 PyPDF2 進行 PDF 解析

💻 使用示例

基礎用法

在 Python 腳本中初始化並啟動服務：

from dicom_mcp import DicomMcpServer

# 創建配置文件
config = {
    "port": 11112,
    "title": "DicomMcp Server",
    "description": "A DICOM server following the Model Context Protocol"
}

# 初始化服務
server = DicomMcpServer(config)

# 啟動服務
server.start()

高級用法

通過命令行啟動服務：

python -m dicom_mcp.run --config config.json

📚 詳細文檔

功能模塊

核心組件

• server.py：實現 MCP 服務器邏輯。
• dicom_client.py：處理 DICOM 請求和響應。
• attributes.py：定義 DICOM 屬性預設。
• config.py：管理配置文件。

測試用例

在 tests/ 文件夾中提供多個測試腳本，包括：

pytest tests/test_dicom_mcp.py  # 運行所有測試
pytest tests/test_dicom_pdf.py  # 測試 PDF 解析功能

開發環境

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
pip install -e .

3. 啟動測試用例的 Orthanc 服務器：

cd tests
docker-compose up -d

4. 運行測試：

pytest tests/test_dicom_mcp.py
pytest tests/test_dicom_pdf.py

📄 許可證

DicomMcp 項目在 MIT 協議下開源，具體細節請參見 LICENSE 文件。

致謝

• 基於 pynetdicom 開發
• 遵循 Model Context Protocol 規範
• 使用 PyPDF2 進行 PDF 解析