Řešení problémů

Server se nespustí

ModuleNotFoundError: No module named 'czechmedmcp'

# Přeinstalujte balíček (pro vývojáře)
uv sync --all-extras
# Nebo přeinstalujte CLI nástroj
uv tool install git+https://github.com/petrsovadina/CzechMedMCP.git --force

command not found: czechmedmcp

# Ověřte instalaci
uv tool list | grep czechmedmcp
# Nebo zkuste přes uv run
uv run czechmedmcp run

Claude Desktop nevidí nástroje

1. Ověřte konfiguraci v claude_desktop_config.json
2. Restartujte Claude Desktop
3. Zkontrolujte, že uv je v PATH:

   which uv

4. Vyzkoušejte absolutní cestu v konfiguraci:

   {
     "mcpServers": {
       "czechmedmcp": {
         "command": "/Users/vase_jmeno/.cargo/bin/uv",
         "args": ["run", "--with", "czechmedmcp", "czechmedmcp", "run"]
       }
     }
   }

Pomalé odpovědi

CzechMedMCP cachuje HTTP odpovědi. První dotaz může být pomalší, následné budou rychlejší.

• Cache TTL: 1 týden (výchozí)
• Umístění: ~/.cache/czechmedmcp/http_cache
• Vymazání: rm -rf ~/.cache/czechmedmcp/

Chyby českých zdrojů

SUKL API neodpovídá

SUKL API může být občas pomalé nebo nedostupné. CzechMedMCP má vestavěný retry s exponenciálním backoffem a circuit breaker.

Timeout: 30 sekund (konfigurovatelný přes CZECH_HTTP_TIMEOUT).

MKN-10 data se nenačítají

MKN-10 data se načítají do paměti při prvním dotazu (~20 MB). Pokud načtení selže, zkuste:

# Ověřte konektivitu
curl -s https://mkn10.uzis.cz/api/ | head -c 100

Hlášení chyb

Nahlaste problém na GitHub Issues  s:

• Verzí CzechMedMCP (czechmedmcp --version)
• Verzí Pythonu (python --version)
• Popisem problému a error logem