JamesANZ/medical-mcp

> **Bring trusted medical data directly into your AI workflow.** A local server for private, free access to FDA, WHO, PubMed, RxNorm, Semantic Scholar, and Google Scholar. No API keys. No data leaks.
An MCP (Model Context Protocol) server that brings authoritative medical information into AI coding environments like Cursor and Claude Desktop.
Why Use Medical MCP?
- 🔒 **Your Data Never Leaves** – Runs 100% locally; no tracking, no logs, no cloud
- 🆓 **No API Keys** – Works out of the box, zero configuration
- 🏥 **Authoritative Sources** – FDA, TGA, Health Canada, EMA, DailyMed, WHO, PubMed, RxNorm, ClinicalTrials.gov
- ⚡ **Easy Setup** – One-click install in Cursor or simple manual setup
- 🔬 **Comprehensive** – Drug info, health stats, medical literature, clinical guidelines, pediatric sources
- 🛡️ **Resilient** – Circuit breakers, retry with backoff, rate limiting, and automatic fallbacks
- 📊 **Evidence-Graded** – Results tagged with study type and evidence level (Meta-Analysis → Case Report). Tags are automatic labels from the title and abstract, not independently checked grades.
- 🏥 **Health Monitoring** – Built-in health check tool to diagnose source availability
What's New in v2.0
- **Resilience Layer** – Circuit breakers per source, retry with exponential backoff + jitter, per-source token bucket rate limiters
- **Monid web search** – Scholar, AAP, and PMC HTML go through Monid TinyFish (Tavily-style search/fetch). Semantic Scholar is the no-key fallback
- **Evidence Grading** – PubMed and multi-database results tagged with study type (Systematic Review, RCT, Cohort, Case Report, etc.) and evidence grade (I–V). These tags are automatic labels from the title and abstract, not independently checked grades.
- **Response Validation** – Zod schemas validate all upstream API responses, logging warnings on schema drift without breaking
- **NCBI API Key Support** – Optional NCBI_API_KEY env var boosts PubMed from 3 req/sec to 10 req/sec
- **Health Check Tool** – health-check pings all upstream sources and reports latency, circuit breaker states, rate limiter status, and cache health
- **Structured Logging** – Leveled, structured logging (DEBUG/INFO/WARN/ERROR) with source tracking and timing for every API call
- **Request Timeouts** – All upstream calls have explicit response/deadline timeouts to prevent hanging
Quick Start
**Install in Cursor (Recommended):**
🔗 Install in Cursor
**Or install manually:**
Features
💊 Drug Information
- **search-drugs** – Search FDA, DailyMed, TGA (Australia), Health Canada, and EMA. Filter with countries (US, AU, CA, EU). Unsupported codes are rejected rather than returned as empty regulatory results.
- **search-drug-nomenclature** – Standardized drug names via RxNorm (limit defaults to 25)
- **search-drug-safety** – FDA FAERS adverse events (with report IDs), recalls, and shortages
📊 Health Statistics
- **get-health-statistics** – WHO Global Health Observatory data (life expectancy, mortality, disease prevalence)
🔬 Medical Literature
- **search-medical-literature** – Search 30M+ PubMed articles (with evidence grading). Optional question or rerank reorders those hits so papers that actually answer the question sit above papers that only share keywords.
- **rank-search-hits** – Same rerank for a list you already have (title + abstract). Retrieval ranking only — not diagnosis or advice.
- **get-article-details** – Detailed article info by PMID
- **search-google-scholar** – Academic papers via Monid TinyFish (research_paper) when MONID_API_KEY is set; otherwise Semantic Scholar
- **search-medical-journals** – Top journals (NEJM, JAMA, Lancet, BMJ, Nature Medicine)
🏥 Clinical Tools
- **search-clinical-guidelines** – Practice recommendations from medical organizations
- **search-clinical-trials** – ClinicalTrials.gov
- **list-sources** – Full catalog of registry adapters and dedicated-tool sources (WHO, PubMed, RxNorm, Scholar, AAP), including which MCP tool reaches each. This is not the search-drugs five-regulator fanout.