# DICOMweb MCP Server

DICOMweb MCP Server is a Claude Code MCP server that connects an AI assistant to a DICOMweb archive. It searches imaging records and reads reports on request.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: PantelisGeorgiadis
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PantelisGeorgiadis/dicomweb-mcp-server
- Updated: 2026-10-19
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/dicomweb-mcp-server

## What it does

The server connects an AI assistant to a DICOM archive through QIDO-RS and WADO-RS. It searches studies, series, and instances, retrieves metadata, extracts text from structured reports and PDFs, and renders image frames.

It requires Node.js 20 or later and a running DICOMweb server that supports QIDO-RS and WADO-RS. Set the archive address with `DICOMWEB_HOST`; authentication can use `DICOMWEB_AUTH` and the matching credentials. Text extraction works on PDFs with an embedded text layer. Scanned page images are not processed with OCR.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DICOMWEB_HOST`, `DICOMWEB_AUTH`, `DICOMWEB_USER`, `DICOMWEB_PASS`, `DICOMWEB_TOKEN`, `DICOMWEB_TIMEOUT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DICOMWEB_HOST=<DICOMWEB_HOST> --env DICOMWEB_AUTH=<DICOMWEB_AUTH> --env DICOMWEB_USER=<DICOMWEB_USER> --env DICOMWEB_PASS=<DICOMWEB_PASS> --env DICOMWEB_TOKEN=<DICOMWEB_TOKEN> --transport stdio dicomweb-mcp-server -- npx -y dicomweb-mcp-server
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add dicomweb-mcp-server --env DICOMWEB_HOST=<DICOMWEB_HOST> --env DICOMWEB_AUTH=<DICOMWEB_AUTH> --env DICOMWEB_USER=<DICOMWEB_USER> --env DICOMWEB_PASS=<DICOMWEB_PASS> --env DICOMWEB_TOKEN=<DICOMWEB_TOKEN> -- npx -y dicomweb-mcp-server
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dicomweb-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "dicomweb-mcp-server"
            ],
            "env": {
                "DICOMWEB_HOST": "<DICOMWEB_HOST>",
                "DICOMWEB_AUTH": "<DICOMWEB_AUTH>",
                "DICOMWEB_USER": "<DICOMWEB_USER>",
                "DICOMWEB_PASS": "<DICOMWEB_PASS>",
                "DICOMWEB_TOKEN": "<DICOMWEB_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dicomweb-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "dicomweb-mcp-server"
            ],
            "env": {
                "DICOMWEB_HOST": "<DICOMWEB_HOST>",
                "DICOMWEB_AUTH": "<DICOMWEB_AUTH>",
                "DICOMWEB_USER": "<DICOMWEB_USER>",
                "DICOMWEB_PASS": "<DICOMWEB_PASS>",
                "DICOMWEB_TOKEN": "<DICOMWEB_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DICOMWEB_HOST=<DICOMWEB_HOST> -e DICOMWEB_AUTH=<DICOMWEB_AUTH> -e DICOMWEB_USER=<DICOMWEB_USER> -e DICOMWEB_PASS=<DICOMWEB_PASS> -e DICOMWEB_TOKEN=<DICOMWEB_TOKEN> dicomweb-mcp-server npx -y dicomweb-mcp-server
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- search DICOM studies using filters
- retrieve series and instances from a study
- extract readable text from structured reports
- read a text-based PDF report in the archive
- render a DICOM image frame

## Example prompts
- Find CT studies for patient John Doe.
- Find every PDF report in study 1.2.3.4.
- Read the report for SOP instance 1.2.3.4.5.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
