DICOMweb MCP Server — Claude Code 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.
MIT ★ 5 updated 2026-10-19
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-serverWhat DICOMweb MCP Server 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.
What it helps with
- 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 for the agent
- 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.
How to install DICOMweb MCP Server
Platform CLI
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-serverReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
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-serverReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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-serverReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about DICOMweb MCP Server
How do I install DICOMweb MCP Server in Claude Code?
Run `claude mcp add dicomweb-mcp-server -e DICOMWEB_HOST=<DICOMWEB_HOST> -e DICOMWEB_PASS=<DICOMWEB_PASS> -e DICOMWEB_TOKEN=<DICOMWEB_TOKEN> -- npx -y dicomweb-mcp-server. Set DICOMWEB_HOST` to the DICOMweb server address.
What does DICOMweb MCP Server do?
It connects an AI assistant to a DICOMweb archive. The server can search studies, series, and instances, retrieve metadata, and read report text.
What does DICOMweb MCP Server need to run?
It requires Node.js 20 or later and a running DICOMweb server with QIDO-RS and WADO-RS support. Set DICOMWEB_HOST; configure DICOMWEB_AUTH and the corresponding credentials if authentication is used.