DICOMweb MCP Server

by PantelisGeorgiadis·io.github.PantelisGeorgiadis/dicomweb-mcp-server·v0.0.4·4 stars

No reviews yet

MCP server exposing a DICOMweb DICOM archive to AI assistants via QIDO-RS and WADO-RS.

B72/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B72/100

full report

Adoption

Growing

4 stars50 downloads/wk

Reviews

Write one

Nobody has reviewed DICOMweb MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

DICOMweb MCP Server tools (9)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

find-encapsulated-pdf-reports
Finds all Encapsulated PDF DICOM instances in a study by searching for DOC-modality series and filtering by EP SOP Class UIDs. Requires a Study Instance UID from find-studies.
find-instances
Searches DICOM instances within a single series, sorted by Instance Number ascending. Requires Study and Series Instance UIDs from find-studies and find-series.
find-series
Searches DICOM series within a single study. Returns series sorted by series date, newest first. Does not retrieve instances or image data. Requires a Study Instance UID from find-studies.
find-structured-reports
Finds all Structured Report (SR) DICOM instances in a study by searching for SR-modality series and filtering by SR SOP Class UIDs. Requires a Study Instance UID from find-studies.
find-studies
Searches DICOM studies on the configured DICOMweb server. Returns studies sorted by study date, newest first. Does not retrieve series, instances, or image data.
get-encapsulated-pdf-report-text
Retrieves and converts an Encapsulated PDF instance to human-readable text. Requires Study, Series, and SOP Instance UIDs from find-encapsulated-pdf-reports. Does not retrieve image data.
get-instance-metadata
Retrieves and converts a DICOM instance to human-readable text. Requires Study, Series, and SOP Instance UIDs from find-instances. Does not retrieve image data.
get-structured-report-text
Retrieves and converts a Structured Report (SR) instance to human-readable text. Requires Study, Series, and SOP Instance UIDs from find-structured-reports. Does not retrieve image data.
render-instance-frame
Renders a specific frame from a DICOM instance to an image format. Requires Study, Series, and SOP Instance UIDs from find-instances, and a frame number. Returns the rendered image as a base64-encoded string.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan2 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 134 days ago8/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How DICOMweb MCP Server compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 72/100; higher than 38% of 48,255 servers
Tools: 9; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 4; more than 82% of 28,688 servers
Downloads a week: 50; more than 42% of 12,191 servers with a package

What its tools let an agent do: 9 read

Install DICOMweb MCP Server in Claude Code, Cursor or VS Code

Runs npx -y dicomweb-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add dicomweb-mcp-server -- npx -y dicomweb-mcp-server

Add to Cursor

What the publisher says

From the DICOMweb MCP Server repository's README, as published. We do not edit it. Read it on GitHub

[![NPM version][npm-version-image]][npm-url] [![NPM downloads][npm-downloads-image]][npm-url] [![build][build-image]][build-url] [![MIT License][license-image]][license-url] [![dicomweb-mcp-server MCP server][glama-score-image]][glama-score-url]

dicomweb-mcp-server

A [Model Context Protocol (MCP)][mcp-url] server that exposes a DICOMweb-compliant DICOM archive to AI assistants. It lets any MCP-capable client search studies, series and instances, inspect metadata, read Structured and Encapsulated PDF Reports, and render image frames — all through natural language.

Requirements

Node.js 20 or later
A running DICOMweb server supporting QIDO-RS and WADO-RS (e.g. [orthanc][orthanc-url])

The following endpoints must be supported by the DICOMweb server:

Installation

Using npx (recommended — no local install needed)

npx dicomweb-mcp-server

The server reads its configuration from a .env file located in the same directory as the script (see Configuration below).

Global install

npm install -g dicomweb-mcp-server
dicomweb-mcp-server

Configuration

Create a .env file with the connection details for your DICOMweb server. Place the file next to wherever the server is executed from (or in the working directory you configure in your MCP client).

# Required
DICOMWEB_HOST=https://your-dicomweb-server/dicomweb

# Optional — authentication
DICOMWEB_AUTH=basic        # basic | bearer
DICOMWEB_USER=username     # required when DICOMWEB_AUTH=basic
DICOMWEB_PASS=password     # required when DICOMWEB_AUTH=basic
DICOMWEB_TOKEN=your-token  # required when DICOMWEB_AUTH=bearer

# Optional — request timeout (milliseconds)
DICOMWEB_TIMEOUT=30000

MCP Client Setup

Claude Desktop

Add the server to claudedesktopconfig.json:

{
  "mcpServers": {
    "dicomweb": {
      "command": "npx",
      "args": ["-y", "dicomweb-mcp-server"],
      "env": {
        "DICOMWEB_HOST": "https://your-dicomweb-server/dicomweb"
      }
    }
  }
}

You can supply all environment variables directly in the env block instead of using a .env file.

VS Code (GitHub Copilot Agent Mode)

Add to your VS Code settings.json or workspace .vscode/mcp.json:

{
  "servers": {
    "dicomweb": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dicomweb-mcp-server"],
      "env": {
        "DICOMWEB_HOST": "https://your-dicomweb-server/dicomweb"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root, or to the global ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dicomweb": {
      "command": "npx",
      "args": ["-y", "dicomweb-mcp-server"],
      "env": {
        "DICOMWEB_HOST": "https://your-dicomweb-server/dicomweb"
      }
    }
  }
}

Available Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

DICOMweb MCP Server: common questions

Is DICOMweb MCP Server safe?: Mostly: it is graded B (72/100). Read the DICOMweb MCP Server safety report
How do I install DICOMweb MCP Server?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does DICOMweb MCP Server need an API key?: Yes. The registry entry asks for DICOMWEB_PASS, DICOMWEB_TOKEN.
Is DICOMweb MCP Server maintained?: The last commit was 172 days ago (2026-05-16). The latest release is v0.0.4.
How does DICOMweb MCP Server compare with other MCP servers?: safety score 72/100 (higher than 38% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 72/100
Stars: 4
Downloads/wk: 50
Price: Free
Licence: MIT
Transport: Local · npm
Version: 0.0.4
Category: Everything else
Last release: 2026-05-16

Credentials it needs

DICOMWEB_HOSTBase URL of the DICOMweb server (used for both QIDO-RS and WADO-RS requests).
DICOMWEB_AUTHAuthentication type: 'basic' or 'bearer'. Omit for unauthenticated access.
DICOMWEB_USERUsername for Basic authentication. Required when DICOMWEB_AUTH=basic.
DICOMWEB_PASSsecretPassword for Basic authentication. Required when DICOMWEB_AUTH=basic.
DICOMWEB_TOKENsecretBearer token for authentication. Required when DICOMWEB_AUTH=bearer.
DICOMWEB_TIMEOUTFetch request timeout in milliseconds. Omit to disable timeout.

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/pantelisgeorgiadis-dicomweb-mcp-server.svg)](https://mcp.market/server/pantelisgeorgiadis-dicomweb-mcp-server)

How the badge works