CzechMedMCP: AI napojení na české zdravotnictví

Open source MCP server se 60 nástroji pro české i globální zdravotnické zdroje. Propojuje Claude, Cursor a další AI asistenty s SUKL, MKN-10, PubMed a dalšími databázemi.

Dokumentace · GitHub

Rychlý startů

# Instalace z GitHubu
uv tool install git+https://github.com/petrsovadina/CzechMedMCP.git

Claude Desktop / Cursor / VS Code...

Přidejte do konfigurace MCP serverů:

{
  "mcpServers": {
    "czechmedmcp": {
      "command": "czechmedmcp",
      "args": ["run"]
    }
  }
}

Remote HTTP server

Pro vzdálený přístup (produkce běží na Railway):

czechmedmcp run --mode streamable_http --host 0.0.0.0 --port 8000

MCP Inspector (testování)

npx @modelcontextprotocol/inspector czechmedmcp run

Katalog nástrojů (60)

České zdravotnické nástroje (23)

Globální biomedicínské nástroje (37)

Konfigurace

cp .env.example .env

České zdravotnické nástroje nevyžadují žádné API klíče — všechna data jsou veřejná.

Vývoj

# Instalace a nastavení
uv sync --all-extras && uv run pre-commit install

# Spuštění testů
uv run python -m pytest -x --ff -n auto --dist loadscope

# Lint + formátování
uv run ruff check src tests && uv run ruff format src tests

# Kompletní kontrola kvality
make check

Deployment

Docker (lokální)

docker compose up --build
# MCP endpoint: http://localhost:8000/mcp
# Health:       http://localhost:8000/health

Railway

Push na main spustí auto-deploy (CI musí projít). Konfigurace:

• Dockerfile — Python 3.11-slim, .[worker] extras

• railway.json — healthcheck na /health, restart on failure

• Env vars: MCP_MODE=streamable_http, PORT nastavuje Railway automaticky

Ruční deploy:

railway up --detach

Arcade Cloud

Alternativní deployment přes Arcade — spravovaná platforma s auth, discovery a multi-user přístupem:

# Instalace CLI
uv tool install arcade-mcp

# Login + deploy (60 nástrojů)
arcade login
arcade deploy -e src/czechmedmcp/arcade/entrypoint.py

# PoC deploy (5 nástrojů pro validaci)
arcade deploy -e src/czechmedmcp/arcade/poc_entrypoint.py

Arcade vyžaduje optional dependency: uv sync --extra arcade

Vercel (web + docs)

Obě Next.js aplikace se deployují automaticky z monorepa:

• Landing page: root directory apps/, framework Next.js

• Dokumentace: root directory apps/docs, static export (output: 'export')

Licence

MIT — plná svoboda komerčního využití.