Medical MCP Server

A Model Context Protocol (MCP) server that provides comprehensive medical information by querying multiple authoritative medical APIs including FDA, WHO, PubMed, and RxNorm.

🔒 Security Features

Localhost-Only Binding: This server is configured for maximum security with localhost-only access:

• Stdio Mode (Default): Inherently localhost-only process communication

• HTTP Mode: Binds to 127.0.0.1 only, blocks all external connections

• IP Filtering: Validates all incoming connections against localhost addresses

• CORS Restrictions: Only allows localhost origins

• Security Logging: All blocked connection attempts are logged

See SECURITY.md for detailed security configuration.

Features

This MCP server offers five specialized tools for querying medical information from reliable sources:

💊 Drug Information Tools

search-drugs

Search for drug information using the FDA database.

Input:

• query (string): Drug name to search for (brand name or generic name)

• limit (optional, number): Number of results to return (1-50, default: 10)

Output:

• Drug information including brand name, generic name, manufacturer, route, dosage form, and purpose

Example:

get-drug-details

Get detailed information about a specific drug by NDC (National Drug Code).

Input:

• ndc (string): National Drug Code (NDC) of the drug

Output:

• Comprehensive drug information including warnings, drug interactions, and clinical pharmacology

📊 Health Statistics Tools

get-health-statistics

Get health statistics and indicators from WHO Global Health Observatory.

Input:

• indicator (string): Health indicator to search for (e.g., 'Life expectancy', 'Mortality rate')

• country (optional, string): Country code (e.g., 'USA', 'GBR')

• limit (optional, number): Number of results to return (1-20, default: 10)

Output:

• Health statistics with values, ranges, and temporal data

Example:

🔬 Medical Literature Tools

search-medical-literature

Search for medical research articles in PubMed.

Input:

• query (string): Medical topic or condition to search for

• max_results (optional, number): Maximum number of articles to return (1-20, default: 10)

Output:

• Medical research articles with titles, PMIDs, journals, and publication dates

Example:

search-google-scholar

Search for academic research articles using Google Scholar.

Input:

• query (string): Academic topic or research query to search for

Output:

• Academic research articles with titles, authors, abstracts, journals, years, citations, and URLs

Example:

Note: This tool uses web scraping to access Google Scholar since it doesn't provide a public API. It includes rate limiting protection and stealth measures to avoid detection.

🏥 Drug Nomenclature Tools

search-drug-nomenclature

Search for drug information using RxNorm (standardized drug nomenclature).

Input:

• query (string): Drug name to search for in RxNorm database

Output:

• Standardized drug information with RxCUI codes, synonyms, and term types

Installation

1. Clone this repository:

2. Install dependencies:

3. Build the project:

Usage

Running the Server

Start the MCP server:

The server runs on stdio and can be connected to any MCP-compatible client.

Example Queries

Here are some example queries you can make with this MCP server:

Search for Drug Information

Get Drug Details by NDC

Get Health Statistics

Search Medical Literature

Search Drug Nomenclature

API Endpoints

This MCP server integrates with the following medical APIs:

FDA API

• GET /drug/label.json - Drug labeling information

• Search by brand name, generic name, or NDC

• Provides safety information, warnings, and clinical data

WHO Global Health Observatory API

• GET /api/Indicator - Health statistics and indicators

• Global health data with country-specific information

• Temporal data for trend analysis

PubMed API

• GET /esearch.fcgi - Search for medical articles

• GET /efetch.fcgi - Retrieve article details

• Access to millions of medical research papers

RxNorm API

• GET /REST/drugs.json - Standardized drug nomenclature

• Drug name standardization and relationships

• Clinical drug information

Google Scholar (Web Scraping)

• Web scraping of Google Scholar search results

• Academic research article discovery

• Citation and publication information

• Note: Uses Puppeteer for browser automation with anti-detection measures

Data Sources

FDA (Food and Drug Administration)

• Source: Official FDA drug labeling database

• Coverage: All FDA-approved drugs in the United States

• Data: Drug safety, efficacy, dosage, warnings, and interactions

• Update Frequency: Real-time as drugs are approved or labeling changes

WHO (World Health Organization)

• Source: Global Health Observatory database

• Coverage: Global health statistics from 194 countries

• Data: Life expectancy, mortality rates, disease prevalence, and health indicators

• Update Frequency: Annual updates with historical data

PubMed (National Library of Medicine)

• Source: MEDLINE database of medical literature

• Coverage: Over 30 million citations from medical journals

• Data: Research articles, clinical studies, and medical reviews

• Update Frequency: Daily updates as new articles are published

RxNorm (National Library of Medicine)

• Source: Standardized drug nomenclature system

• Coverage: Clinical drugs available in the United States

• Data: Drug names, codes, relationships, and clinical information

• Update Frequency: Weekly updates

Google Scholar (Web Scraping)

• Source: Google Scholar academic search engine

• Coverage: Academic papers, theses, books, and abstracts across all disciplines

• Data: Research articles, citations, authors, journals, and publication dates

• Update Frequency: Real-time as new papers are indexed

• Note: Access via web scraping with rate limiting protection

Error Handling

The server includes comprehensive error handling:

• Network errors are caught and reported with descriptive messages

• Invalid queries return appropriate error messages

• Rate limiting and API errors are handled gracefully

• Fallback responses when specific APIs are unavailable

Web Scraping Implementation

The Google Scholar integration uses Puppeteer for web scraping with the following features:

Anti-Detection Measures

• Stealth Mode: Browser launched with multiple flags to avoid detection

• User Agent Spoofing: Realistic browser user agent strings

• Random Delays: Built-in delays between requests to avoid rate limiting

• Header Spoofing: Realistic HTTP headers to appear as a regular browser

• Viewport Settings: Standard desktop viewport dimensions

Robust Parsing

• Multiple Selectors: Uses various CSS selectors to handle different Google Scholar layouts

• Fallback Strategies: Multiple parsing approaches for different page structures

• Error Recovery: Graceful handling of missing elements or changed page structures

• Data Validation: Filters out incomplete or invalid results

Rate Limiting Protection

• Random Delays: 1-3 second random delays between requests

• Browser Management: Proper browser cleanup to prevent resource leaks

• Timeout Handling: Configurable timeouts for network requests

• Error Recovery: Automatic retry logic for failed requests

🚀 Usage

Stdio Mode (Default - Most Secure)

HTTP Mode (Localhost-Only)

Development Mode

🤖 Claude Desktop Integration

Setup Instructions

1. Install and Build the Server

2. Configure Claude Desktop

Create or edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Replace the paths with your actual installation directory:

For users with NVM (Node Version Manager):

For users with system Node.js:

To find your Node.js path:

3. Restart Claude Desktop

• Close Claude Desktop completely

• Reopen Claude Desktop

• The Medical MCP Server will start automatically

Available Medical Tools in Claude

Once connected, you'll have access to these medical tools:

🔍 Search Tools

• search-drugs - Search FDA drug database

• search-pubmed-articles - Search medical literature

• search-google-scholar - Search academic research

• search-medical-databases - Comprehensive multi-database search

• search-medical-journals - Search top medical journals

💊 Drug Information Tools

• get-drug-by-ndc - Get drug details by NDC code

• check-drug-interactions - Check drug interactions

• get-drug-safety-info - Get drug safety information

🏥 Clinical Tools

• generate-differential-diagnosis - Generate differential diagnoses

• get-diagnostic-criteria - Get diagnostic criteria for conditions

• get-risk-calculators - Get clinical risk calculators

• get-lab-values - Get normal lab value ranges

📊 Health Data Tools

• get-health-indicators - Get WHO health statistics

• search-rxnorm-drugs - Search RxNorm drug database

• search-clinical-guidelines - Search clinical guidelines

Example Claude Conversations

Drug Information Query

Clinical Decision Support

Research and Literature Review

🔒 Security Features in Claude

• Localhost-Only: Server runs locally, no external access

• Process Isolation: Medical data stays on your machine

• No Data Storage: No medical data is stored locally

• Dynamic Data: All information retrieved in real-time

• Audit Logging: All queries are logged for transparency

Troubleshooting

Server Won't Start

Claude Can't Connect

1. Verify the configuration file path is correct

2. Ensure the server executable path is absolute

3. Check that Node.js is in your PATH

4. Restart Claude Desktop after configuration changes

Permission Issues

Network Issues

• The server uses localhost-only binding for security

• No external network access required for the server itself

• Medical data is fetched from external APIs when needed

Best Practices

For Medical Professionals

• Always verify information through multiple sources

• Use as a starting point for research, not final decisions

• Follow established clinical guidelines

• Document your decision-making process

For Students and Researchers

• Use for literature reviews and research

• Cross-reference with primary sources

• Understand the limitations of AI-generated summaries

• Always cite original sources

For General Users

• Use for educational purposes only

• Never replace professional medical advice

• Consult healthcare providers for medical decisions

• Be aware of information limitations

Advanced Configuration

Custom Port (if needed)

Environment Variables

🔒 Security Verification

Test Localhost Access

Check Binding

Medical Disclaimer

Important: This MCP server provides information from authoritative medical sources but should not be used as a substitute for professional medical advice, diagnosis, or treatment. Always consult with qualified healthcare professionals for medical decisions.

• The information provided is for educational and informational purposes only

• Drug information may not be complete or up-to-date for all medications

• Health statistics are aggregated data and may not reflect individual circumstances

• Medical literature should be interpreted by qualified healthcare professionals

Dependencies

• @modelcontextprotocol/sdk - MCP SDK for server implementation

• superagent - HTTP client for API requests

• puppeteer - Browser automation for web scraping Google Scholar

• zod - Schema validation for tool parameters

License

This project is licensed under the MIT License - see the LICENSE.md file for details.