DicomMcp 简介

DicomMcp 是一个遵循 Model Context Protocol (MCP) 规范的 DICOM 服务端实现，用于与模型建立上下文连接。它基于 pynetdicom 开发，并支持 PDF 文本提取功能。

特性

• 遵循 MCP 协议
• 支持 DICOM 标准
• 提供配置管理
• 包含测试用例
• 使用 PyPDF2 进行 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

功能模块

核心组件

• 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 解析