🚀 DicomMcp 简介
DicomMcp 是一个遵循 Model Context Protocol (MCP) 规范的 DICOM 服务端实现，可用于与模型建立上下文连接。它基于 pynetdicom 开发，还支持 PDF 文本提取功能，为相关应用场景提供了便利。
🚀 快速开始
初始化服务
在 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 解析
📦 安装指南
通过 pip 安装：
pip install dicom-mcp
📚 详细文档
配置
创建一个配置文件 config.json，内容如下：
{
"port": 11112,
"title": "DicomMcp Server",
"description": "A DICOM server following the Model Context Protocol"
}
功能模块
核心组件
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 解析功能
开发环境
- 克隆仓库：
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 .
- 启动测试用例的 Orthanc 服务器：
cd tests
docker-compose up -d
- 运行测试：
pytest tests/test_dicom_mcp.py
pytest tests/test_dicom_pdf.py
📄 许可证
DicomMcp 项目在 MIT 协议下开源，具体细节请参见 LICENSE 文件。
致谢
- 基于 pynetdicom 开发
- 遵循 Model Context Protocol 规范
- 使用 PyPDF2 进行 PDF 解析