DICOM

🚀 DicomMcp Introduction

DicomMcp is a DICOM server implementation that adheres to the Model Context Protocol (MCP) specification, used to establish a context connection with the model. It is developed based on pynetdicom and supports PDF text extraction.

✨ Features

• Complies with the MCP protocol.
• Supports the DICOM standard.
• Provides configuration management.
• Includes test cases.
• Uses PyPDF2 for PDF parsing.

📦 Installation

Install via pip:

pip install dicom-mcp

📚 Configuration

Create a configuration file config.json with the following content:

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

🚀 Quick Start

Initialize the Service

Initialize the DicomMcp service in a Python script:

from dicom_mcp import DicomMcpServer

# Create a configuration file
config = {
    "port": 11112,
    "title": "DicomMcp Server",
    "description": "A DICOM server following the Model Context Protocol"
}

# Initialize the service
server = DicomMcpServer(config)

# Start the service
server.start()

Start via the Command Line

Run via the command line:

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

💻 Usage Examples

Core Components

• server.py: Implements the MCP server logic.
• dicom_client.py: Handles DICOM requests and responses.
• attributes.py: Defines DICOM attribute presets.
• config.py: Manages the configuration file.

Test Cases

Multiple test scripts are provided in the tests/ folder, including:

pytest tests/test_dicom_mcp.py  # Run all tests
pytest tests/test_dicom_pdf.py  # Test the PDF parsing function

🔧 Technical Details

Development Environment

1. Clone the repository:

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

2. Create a virtual environment and install dependencies:

   python -m venv .venv
   source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
   pip install -e .
   

3. Start the Orthanc server for test cases:

   cd tests
   docker-compose up -d
   

4. Run tests:

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

📄 License

The DicomMcp project is open - source under the MIT license. For specific details, please refer to the LICENSE file.

Acknowledgments

• Developed based on pynetdicom.
• Complies with the Model Context Protocol specification.
• Uses PyPDF2 for PDF parsing.