Medical MCP Server

1# 🩺 Medical MCP Server
2 
3> **Bring trusted medical data directly into your AI workflow.** A local server for private, free access to FDA, WHO, PubMed, RxNorm, and Google Scholar. No API keys. No data leaks.
4 
5An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that brings authoritative medical information into AI coding environments like Cursor and Claude Desktop.
6 
7<a href="https://glama.ai/mcp/servers/@JamesANZ/medical-mcp">
8  <img width="380" height="200" src="https://glama.ai/mcp/servers/@JamesANZ/medical-mcp/badge" alt="medical-mcp MCP server" />
9</a>
10 
11[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/JamesANZ/medical-mcp)](https://archestra.ai/mcp-catalog/jamesanz__medical-mcp)
12 
13## Why Use Medical MCP?
14 
15- 🔒 **Your Data Never Leaves** – Runs 100% locally; no tracking, no logs, no cloud
16- 🆓 **No API Keys** – Works out of the box, zero configuration
17- 🏥 **Authoritative Sources** – FDA, WHO, PubMed, RxNorm, Google Scholar, AAP, pediatric journals
18- ⚡ **Easy Setup** – One-click install in [Cursor](https://cursor.sh) or simple manual setup
19- 🔬 **Comprehensive** – Drug info, health stats, medical literature, clinical guidelines, pediatric sources
20 
21## Quick Start
22 
23Ready to bring medical intelligence into your AI workflow? Install in seconds:
24 
25**Install in Cursor (Recommended):**
26 
27[🔗 Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=medical-mcp&config=eyJtZWRpY2FsLW1jcCI6eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1lZGljYWwtbWNwIl19fQ==)
28 
29**Or install manually:**
30 
31```bash
32npm install -g medical-mcp
33# Or from source:
34git clone https://github.com/JamesANZ/medical-mcp.git
35cd medical-mcp && npm install && npm run build
36```
37 
38## Features
39 
40### 💊 Drug Information
41 
42- **`search-drugs`** – Search FDA database by brand or generic name
43- **`get-drug-details`** – Get comprehensive drug info by NDC code
44- **`search-drug-nomenclature`** – Standardized drug names via RxNorm
45 
46### 📊 Health Statistics
47 
48- **`get-health-statistics`** – WHO Global Health Observatory data (life expectancy, mortality, disease prevalence)
49 
50### 🔬 Medical Literature
51 
52- **`search-medical-literature`** – Search 30M+ PubMed articles
53- **`get-article-details`** – Detailed article info by PMID
54- **`search-google-scholar`** – Academic research with citations
55- **`search-medical-databases`** – Multi-database search (PubMed, Scholar, Cochrane, ClinicalTrials.gov)
56- **`search-medical-journals`** – Top journals (NEJM, JAMA, Lancet, BMJ, Nature Medicine)
57 
58### 🏥 Clinical Tools
59 
60- **`search-clinical-guidelines`** – Practice recommendations from medical organizations
61 
62### 👶 Pediatric Sources
63 
64- **`search-pediatric-guidelines`** – AAP guidelines and Bright Futures preventive care
65- **`search-pediatric-literature`** – Research from major pediatric journals (Pediatrics, JAMA Pediatrics, etc.)
66- **`get-child-health-statistics`** – Pediatric health indicators from WHO (mortality, immunization, nutrition)
67- **`search-pediatric-drugs`** – Drugs with pediatric labeling and dosing information
68- **`search-aap-guidelines`** – Comprehensive AAP guideline search (Bright Futures + Policy Statements)
69 
70### 📊 Cache Management
71 
72- **`get-cache-stats`** – View cache statistics (hit rate, memory usage, entry count)
73 
74## Installation
75 
76### Cursor (One-Click)
77 
78Click the install link above or use:
79 
80```
81cursor://anysphere.cursor-deeplink/mcp/install?name=medical-mcp&config=eyJtZWRpY2FsLW1jcCI6eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1lZGljYWwtbWNwIl19fQ==
82```
83 
84### Manual Installation
85 
86**Requirements:** Node.js 18+ and npm
87 
88```bash
89# Clone and build
90git clone https://github.com/JamesANZ/medical-mcp.git
91cd medical-mcp
92npm install
93npm run build
94 
95# Run server
96npm start
97```
98 
99### Claude Desktop
100 
101Add to `claude_desktop_config.json`:
102 
103**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
104**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
105 
106```json
107{
108  "mcpServers": {
109    "medical-mcp": {
110      "command": "node",
111      "args": ["/absolute/path/to/medical-mcp/build/index.js"]
112    }
113  }
114}
115```
116 
117Restart Claude Desktop after configuration.
118 
119## Usage Examples
120 
121### Search for Drug Information
122 
123Ask about a medication's uses, dosage, and safety information:
124 
125```json
126{
127  "tool": "search-drugs",
128  "arguments": { "query": "Tylenol", "limit": 5 }
129}
130```
131 
132### Get Health Statistics
133 
134Retrieve global health indicators like life expectancy or mortality rates:
135 
136```json
137{
138  "tool": "get-health-statistics",
139  "arguments": {
140    "indicator": "Life expectancy at birth (years)",
141    "country": "USA"
142  }
143}
144```
145 
146### Search Medical Literature
147 
148Find peer-reviewed research articles on any medical topic:
149 
150```json
151{
152  "tool": "search-medical-literature",
153  "arguments": { "query": "COVID-19 treatment", "max_results": 10 }
154}
155```
156 
157## Data Sources
158 
159| Source                 | Coverage                                                     | Update Frequency |
160| ---------------------- | ------------------------------------------------------------ | ---------------- |
161| **FDA**                | All FDA-approved drugs (US)                                  | Real-time        |
162| **WHO**                | Global health stats (194 countries)                          | Annual           |
163| **PubMed**             | 30M+ medical citations                                       | Daily            |
164| **RxNorm**             | Standardized drug nomenclature (US)                          | Weekly           |
165| **Google Scholar**     | Academic papers across disciplines                           | Real-time        |
166| **AAP**                | Bright Futures guidelines & policy statements                | Periodic         |
167| **Pediatric Journals** | Major pediatric journals (Pediatrics, JAMA Pediatrics, etc.) | Daily            |
168 
169## Security & Privacy
170 
171- ✅ **Localhost-only** – Server runs locally, no external access
172- ✅ **No data storage** – All queries are real-time, nothing saved
173- ✅ **Process isolation** – Medical data stays on your machine
174- ✅ **No API keys** – No credentials to manage or leak
175 
176## Use Cases
177 
178- **Medical Researchers** – Quick literature reviews without paywalls
179- **Healthcare Developers** – Build prototypes with real medical data
180- **Students** – Access drug information and research papers
181- **Clinicians** – Reference tool for drug details and health statistics
182- **Pediatricians** – AAP guidelines, Bright Futures, pediatric literature, and child health data
183 
184## Caching
185 
186The server includes an in-memory caching layer to improve response times and reduce API calls:
187 
188- **Automatic Caching**: All API responses are cached with source-specific TTL policies
189- **TTL Policies**:
190  - FDA data: 24 hours
191  - PubMed articles: 1 hour
192  - WHO statistics: 7 days
193  - RxNorm nomenclature: 30 days
194  - Clinical guidelines: 7 days
195  - Google Scholar: 1 hour
196  - Bright Futures: 30 days
197  - AAP Policy: 7 days
198  - Pediatric journals: 1 hour
199  - Child health indicators: 7 days
200  - Pediatric drugs: 24 hours
201- **Cache Management**: Automatic cleanup of expired entries every 5 minutes
202- **LRU Eviction**: Least recently used entries are evicted when cache exceeds 1000 entries
203- **Cache Statistics**: Use `get-cache-stats` tool to view hit rates and memory usage
204 
205**Configuration** (via environment variables):
206 
207- `CACHE_ENABLED=true` - Enable/disable caching (default: true)
208- `CACHE_MAX_SIZE=1000` - Maximum cache entries (default: 1000)
209- `CACHE_TTL_FDA=86400` - FDA TTL in seconds (default: 86400)
210- `CACHE_TTL_PUBMED=3600` - PubMed TTL in seconds (default: 3600)
211- `CACHE_TTL_WHO=604800` - WHO TTL in seconds (default: 604800)
212- `CACHE_TTL_RXNORM=2592000` - RxNorm TTL in seconds (default: 2592000)
213- `CACHE_CLEANUP_INTERVAL=300000` - Cleanup interval in milliseconds (default: 300000)
214 
215**Performance**: Cached responses typically return in <10ms vs 800-1500ms for API calls. Expected cache hit rate: 60%+ for common queries.
216 
217## Technical Details
218 
219**Built with:** Node.js, TypeScript, MCP SDK  
220**Dependencies:** `@modelcontextprotocol/sdk`, `superagent`, `puppeteer`, `zod`  
221**Platforms:** macOS, Windows, Linux
222 
223**Note:** Google Scholar access uses web scraping with rate limiting. Other sources use official APIs.
224 
225## Medical Disclaimer
226 
227⚠️ **Important**: This tool provides information from authoritative sources but should **not** replace professional medical advice, diagnosis, or treatment. Always consult qualified healthcare professionals for medical decisions.
228 
229## Contributing
230 
231⭐ **If this project helps you, please star it on GitHub!** ⭐
232 
233Contributions welcome! Please open an issue or submit a pull request.
234 
235## License
236 
237MIT License – see [LICENSE.md](LICENSE.md) for details.
238 
239## Support
240 
241If you find this project useful, consider supporting it:
242 
243**⚡ Lightning Network**
244 
245```
246lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa
247```
248 
249**₿ Bitcoin**: [bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp](https://mempool.space/address/bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp)
250 
251**Ξ Ethereum/EVM**: [0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f](https://etherscan.io/address/0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f)
252