DICOMweb MCP Server

by pantelisgeorgiadisio.github.PantelisGeorgiadis/dicomweb-mcp-serverv0.0.4

Access a DICOMweb archive: search studies, series and instances, inspect metadata, read structured reports, extract PDF text and render frames.

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing5mo ago

Install DICOMweb MCP server

claude mcp add dicomweb -e DICOMWEB_HOST='<dicomweb-host>' -e DICOMWEB_PASS='<dicomweb-pass>' -e DICOMWEB_TOKEN='<dicomweb-token>' -- npx -y dicomweb-mcp-server

{
  "mcpServers": {
    "dicomweb": {
      "command": "npx",
      "args": [
        "-y",
        "dicomweb-mcp-server"
      ],
      "env": {
        "DICOMWEB_HOST": "<dicomweb-host>",
        "DICOMWEB_PASS": "<dicomweb-pass>",
        "DICOMWEB_TOKEN": "<dicomweb-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "dicomweb": {
      "command": "npx",
      "args": [
        "-y",
        "dicomweb-mcp-server"
      ],
      "env": {
        "DICOMWEB_HOST": "<dicomweb-host>",
        "DICOMWEB_PASS": "<dicomweb-pass>",
        "DICOMWEB_TOKEN": "<dicomweb-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "dicomweb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "dicomweb-mcp-server"
      ],
      "env": {
        "DICOMWEB_HOST": "<dicomweb-host>",
        "DICOMWEB_PASS": "<dicomweb-pass>",
        "DICOMWEB_TOKEN": "<dicomweb-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "dicomweb": {
      "command": "npx",
      "args": [
        "-y",
        "dicomweb-mcp-server"
      ],
      "env": {
        "DICOMWEB_HOST": "<dicomweb-host>",
        "DICOMWEB_PASS": "<dicomweb-pass>",
        "DICOMWEB_TOKEN": "<dicomweb-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DICOMWEB_HOST	yes	—	Base URL of the DICOMweb server (used for both QIDO-RS and WADO-RS requests).
DICOMWEB_AUTH	—	—	Authentication type: 'basic' or 'bearer'. Omit for unauthenticated access.
DICOMWEB_USER	—	—	Username for Basic authentication. Required when DICOMWEB_AUTH=basic.
DICOMWEB_PASS	—	yes	Password for Basic authentication. Required when DICOMWEB_AUTH=basic.
DICOMWEB_TOKEN	—	yes	Bearer token for authentication. Required when DICOMWEB_AUTH=bearer.
DICOMWEB_TIMEOUT	—	—	Fetch request timeout in milliseconds. Omit to disable timeout.

Freshness

Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-05-16 · 5mo ago · GitHub
Latest release
2026-05-16 · 5mo ago · GitHub · 0.0.4
Package published
no data · npm/PyPI
Registry entry updated
2026-05-16 · 5mo ago · official registry · v0.0.4

FAQ

›How do I install the DICOMweb MCP server in Claude Code?

Run: claude mcp add dicomweb -e DICOMWEB_HOST='<dicomweb-host>' -e DICOMWEB_PASS='<dicomweb-pass>' -e DICOMWEB_TOKEN='<dicomweb-token>' -- npx -y dicomweb-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does DICOMweb require an API key?

Yes. It expects DICOMWEB_HOST, DICOMWEB_PASS, DICOMWEB_TOKEN, of which 2 are secrets.

›Can I use DICOMweb as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is DICOMweb in the official MCP registry?

Yes, as io.github.PantelisGeorgiadis/dicomweb-mcp-server.