Log inSubmit server
Dicomweb MCP Server logo

Dicomweb MCP Server

by PantelisGeorgiadis

Searches DICOMweb archives, reads report content and metadata, and renders DICOM frames through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Dicomweb MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "pantelisgeorgiadis-dicomweb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "dicomweb-mcp-server"
      ],
      "env": {
        "DICOMWEB_HOST": "YOUR_VALUE_HERE",
        "DICOMWEB_AUTH": "YOUR_VALUE_HERE",
        "DICOMWEB_USER": "YOUR_VALUE_HERE",
        "DICOMWEB_PASS": "YOUR_VALUE_HERE",
        "DICOMWEB_TOKEN": "YOUR_VALUE_HERE",
        "DICOMWEB_TIMEOUT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

PantelisGeorgiadis/dicomweb-mcp-server connects MCP-capable assistants to a DICOMweb-compliant archive through QIDO-RS and WADO-RS requests. It supports hierarchical searches for studies, series, and instances, with filtering, pagination, and sorted results. Additional tools identify and read Structured Reports and Encapsulated PDF reports, format instance metadata, and render selected image frames inline. Reach for it when an assistant needs conversational access to imaging records exposed by an existing DICOMweb server.

Use cases

  • Search imaging studies by patient, date, modality, or DICOM tag
  • Read Structured Report content from a selected study
  • Extract text from searchable Encapsulated PDF reports
  • Inspect all attributes of a DICOM instance
  • Render a selected DICOM frame for review

Key features

  • QIDO-RS study, series, and instance searches
  • DICOM keyword and tag-based query filters
  • Structured Report and Encapsulated PDF discovery
  • Human-readable report and metadata extraction
  • JPEG or PNG frame rendering
  • Basic and bearer authentication

Tools9

What Dicomweb MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~287 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

19/20 checks healthy over the last 85d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · dicomweb-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads222Package downloads in the last 30 days.
Last commit15d agoMost recent push to the default branch.
Tools exposed9Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Dicomweb MCP Server works

What PantelisGeorgiadis/dicomweb-mcp-server does

PantelisGeorgiadis/dicomweb-mcp-server exposes a DICOMweb archive to MCP clients through tools for searching and inspecting imaging data. It can find studies, series, and instances, then use their identifiers to retrieve additional information. Search results are ordered by study or series date in descending order, while instance results are ordered by Instance Number.

The server also handles common non-image content found in DICOM archives. It locates Encapsulated PDF instances and extracts text from searchable PDFs, and it finds Structured Report instances and converts them to readable text. Instance metadata is returned as formatted text without retrieving pixel data. For image review, a selected frame can be rendered as JPEG or PNG and returned inline.

How it works

The archive must provide the DICOMweb QIDO-RS and WADO-RS endpoints used by the tools. Study, series, and instance searches use QIDO-RS. Metadata retrieval, report retrieval, and frame rendering use WADO-RS. The configured base URL is used for both services.

Search tools accept a space-separated sequence of key=value expressions. Keys can be DICOM keyword names or eight-digit hexadecimal tags. The query syntax also supports result limits, offsets, fuzzy name matching, requesting all available attributes, and wildcards where the DICOMweb implementation permits them.

A typical lookup starts with find-studies, continues with find-series and find-instances, and then passes the resulting UIDs to a report, metadata, or frame tool. PDF discovery checks DOC-modality series and the Encapsulated PDF SOP Class UID. Structured Report discovery similarly checks SR-modality series against known SR SOP Class UIDs.

Setup and configuration

Node.js 20 or newer is required. The package can run directly with npx dicomweb-mcp-server, or it can be installed globally with npm before running dicomweb-mcp-server.

Set DICOMWEB_HOST to the DICOMweb base URL. Optional authentication supports either Basic authentication, using DICOMWEB_AUTH=basic with DICOMWEB_USER and DICOMWEB_PASS, or bearer authentication, using DICOMWEB_AUTH=bearer with DICOMWEB_TOKEN. DICOMWEB_TIMEOUT sets the request timeout in milliseconds; omitting it disables the timeout. Configuration can be supplied through a .env file in the execution directory or through the MCP client's environment block.

The documented client configurations use stdio with Claude Desktop, VS Code GitHub Copilot Agent Mode, and Cursor.

Tools and capabilities

  • Search studies, series, and instances with DICOM query filters.
  • Find Encapsulated PDF and Structured Report instances within a study.
  • Extract text from searchable Encapsulated PDF documents.
  • Convert Structured Reports and full instance attributes into human-readable text.
  • Render a 1-based frame as JPEG or PNG.

Limitations and notes

PDF text extraction depends on an embedded text layer. Scanned PDFs without searchable text produce little or no extracted text because OCR is not performed. Frame rendering returns a selected frame rather than pixel data through the metadata tool, and single-frame instances should use frame index 1. The connected archive must support the listed QIDO-RS and WADO-RS paths for the corresponding operations.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Dicomweb MCP Server

PantelisGeorgiadis/dicomweb-mcp-server is an MCP server that connects AI assistants to DICOMweb-compliant archives. Its main tools search studies, series, and instances; inspect metadata; read Structured Reports and Encapsulated PDF text; and render selected DICOM frames through QIDO-RS and WADO-RS.

Install it with Node.js 20 or newer by running `npx dicomweb-mcp-server`, or install it globally with `npm install -g dicomweb-mcp-server` and run `dicomweb-mcp-server`. Configure the archive URL through `DICOMWEB_HOST`.

Configure authentication with environment variables. Use `DICOMWEB_AUTH=basic` together with `DICOMWEB_USER` and `DICOMWEB_PASS`, or use `DICOMWEB_AUTH=bearer` with `DICOMWEB_TOKEN`. Set `DICOMWEB_HOST` to the archive base URL.

Yes, it works with Cursor through a stdio entry in `.cursor/mcp.json` or the global Cursor MCP configuration. The configuration runs `npx -y dicomweb-mcp-server` and passes `DICOMWEB_HOST` in the environment.

No, scanned PDFs without an embedded text layer are not suitable for its PDF text extraction tool. The server extracts text from searchable Encapsulated PDF files and does not perform OCR on image-only documents.

Related MCP servers

All in Biology & Bioinformatics All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDicomweb MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/pantelisgeorgiadis-dicomweb-mcp-server?style=directory)](https://allmcps.com/mcp/pantelisgeorgiadis-dicomweb-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/pantelisgeorgiadis-dicomweb-mcp-server"><img src="https://allmcps.com/api/badge/pantelisgeorgiadis-dicomweb-mcp-server?style=directory" alt="Dicomweb MCP Server on AllMCPs" /></a>