Dicom MCP

🚀 DICOM MCP Server

The DICOM MCP Server is a tool based on the Model Context Protocol (MCP) for interacting with medical imaging systems compliant with the DICOM standard. It supports retrieving and manipulating DICOM data via the MCP protocol and offers some practical features, such as extracting text from PDF documents encapsulated in DICOM instances.

🚀 Quick Start

Start the Server

uvicorn dicom_mcp.server:app --reload

Start with a Configuration File

Create a configuration file 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

Then start the server:

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

✨ Features

Retrieve DICOM Data

Search for Patients

patients = client.search_patients()
for patient in patients:
    print(f"Patient ID: {patient.PatientID}, Name: {patient.Name}")

Search for Studies

studies = client.search_studies(patient_id="12345")
for study in studies:
    print(f"Study Instance UID: {study.StudyInstanceUID}, Modality: {study.Modality}")

Search for Series

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}")

Search for Instances

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}")

Retrieve a Specific Instance

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)

Extract Text from Encapsulated 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)

📦 Installation

Install with pip

pip install dicom-mcp

Install from Source

1. Clone the repository:

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

2. Create and activate a virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install dependencies:

   pip install -e .
   

📚 Documentation

Default Configuration File

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

Custom Configuration

Create a custom configuration file 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

Then start the server:

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

🔧 Technical Details

Clone the Repository

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

Install Dependencies

pip install -r requirements.txt

Start the Development Server

uvicorn dicom_mcp.server:app --reload

🤝 Contribution

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a pull request.

📄 License

This project is licensed under the MIT License.