# PantelisGeorgiadis/dicomweb-mcp-server [Health: Active]

**Category:** Biology, Medicine and Bioinformatics  
**Repository:** https://github.com/PantelisGeorgiadis/dicomweb-mcp-server  
**GitHub Stars:** 4  
**npm Downloads (last month):** 233  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pantelisgeorgiadis-dicomweb-mcp-server

## Description
A DICOMweb MCP server that exposes a DICOMweb-compliant DICOM archive to AI assistants, enabling search of studies, series and instances, metadata inspection, structured report reading, encapsulated PDF text extraction, and frame rendering.

## Tools
Capabilities this server exposes over MCP:

- **find-studies** — Searches DICOM studies on the configured DICOMweb server. Results are sorted by study date, newest first.
- **find-series** — Searches DICOM series within a single study. Results are sorted by series date, newest first.
- **find-instances** — Searches DICOM instances within a single series. Results are sorted by Instance Number ascending.
- **find-encapsulated-pdf-reports** — Finds all Encapsulated PDF instances in a study by looking for DOC-modality series and filtering by the Encapsulated PDF SOP Class UID (`1.2.840.10008.5.1.4.1.1.104.1`).
- **get-encapsulated-pdf-report-text** — Retrieves an Encapsulated PDF DICOM instance and extracts its text content.
- **find-structured-reports** — Finds all Structured Report (SR) instances in a study by looking for SR-modality series and filtering by known SR SOP Class UIDs.
- **get-structured-report-text** — Retrieves a Structured Report instance and converts it to human-readable text.
- **get-instance-metadata** — Retrieves and formats all DICOM attributes of a single instance as human-readable text. Does not retrieve pixel data.
- **render-instance-frame** — Renders a specific frame from a DICOM instance and returns it as an inline image (JPEG or PNG).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "dicomweb-mcp-server": {
    "command": "npx",
    "args": ["-y","dicomweb-mcp-server"],
    "env": {
      "DICOMWEB_HOST": ""
    }
  }
}
```

**Requires environment variables:** `DICOMWEB_HOST` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What PantelisGeorgiadis/dicomweb-mcp-server MCP server does

PantelisGeorgiadis/dicomweb-mcp-server MCP server exposes a DICOMweb archive to MCP-compatible clients. It provides a search-and-inspection workflow that starts with studies, narrows to series and instances, and then retrieves metadata, report text, or rendered frames from a selected instance.

The server expects a DICOMweb implementation that supports both QIDO-RS and WADO-RS. QIDO-RS endpoints are used for study, series, and instance searches. WADO-RS endpoints provide instance metadata, report content, and rendered frames. Orthanc is given as an example of a compatible archive, but the requirement is support for the documented DICOMweb endpoints.

## How it works

Search tools accept a space-separated query made from `key=value` pairs. Keys can use DICOM keyword names, such as `PatientName`, or hexadecimal tags. Queries can also include result limits, offsets, fuzzy name matching, and requests for all available attributes. Wildcards are supported where the DICOMweb archive permits them.

Results are ordered according to the resource level: studies by study date with newer results first, series by series date with newer results first, and instances by ascending Instance Number. The returned identifiers can then be passed to tools that operate on a specific series or instance.

Structured Report and Encapsulated PDF discovery uses modality and SOP Class filtering within a study. Structured Reports are converted into readable text. Encapsulated PDF retrieval extracts text from searchable PDFs; scanned PDFs without an embedded text layer are not OCR-processed.

## Setup and configuration

The server requires Node.js 20 or newer and a reachable DICOMweb archive. Install it with `npx -y dicomweb-mcp-server`, or install the package globally with npm and run the `dicomweb-mcp-server` command.

Set `DICOMWEB_HOST` to the archive’s base DICOMweb URL. Optional authentication settings support either `basic` or `bearer`: basic authentication uses `DICOMWEB_USER` and `DICOMWEB_PASS`, while bearer authentication uses `DICOMWEB_TOKEN`. `DICOMWEB_TIMEOUT` can set a request timeout in milliseconds; omitting it disables the timeout. Configuration can be supplied through a `.env` file in the server’s working directory or through the MCP client’s environment block.

The README includes stdio configurations for Claude Desktop and Cursor. The same server can also be registered in VS Code’s MCP configuration.

## Tools and capabilities

The available tools are:

- Search studies, series, and instances using DICOMweb query filters.
- Locate Encapsulated PDF instances within a study.
- Extract text from an Encapsulated PDF DICOM instance.
- Locate Structured Report instances and convert them to readable text.
- Format all DICOM attributes from one instance without retrieving pixel data.
- Render a selected one-based frame as JPEG or PNG.

Frame rendering accepts frame number `1` for single-frame instances. The rendering tool returns the selected image as an inline image.

## Limitations and notes

The archive must implement the required QIDO-RS and WADO-RS routes. Authentication is optional, but the configured credentials must match the selected authentication mode. PDF text extraction is limited to PDFs containing searchable text and does not perform OCR. Metadata inspection deliberately excludes pixel data, while image access is provided through the separate frame-rendering tool.

The workflow depends on identifiers returned by earlier searches: series searches require a study Instance UID, instance searches require both study and series UIDs, and instance-level retrieval tools require the relevant SOP Instance UID.

_Full upstream README: https://allmcps.com/mcp/pantelisgeorgiadis-dicomweb-mcp-server/readme_