Healthcare MCP Server

A Model Context Protocol (MCP) server providing AI assistants with access to healthcare data and medical information tools.

Features

• FDA Drug Information: Search and retrieve comprehensive drug information from the FDA database
• PubMed Research: Search medical literature from PubMed's database of scientific articles
• Health Topics: Access evidence-based health information from Health.gov
• Clinical Trials: Search for ongoing and completed clinical trials
• Medical Terminology: Look up ICD-10 codes and medical terminology definitions

Installation

Quick Install (Cline Marketplace)

The easiest way to install this server is through the Cline Marketplace:

1. Open Cline and click the Extensions button in the toolbar
2. Search for "Healthcare MCP"
3. Click Install

Manual Installation

1. Clone the repository:

   git clone https://github.com/Cicatriiz/healthcare-mcp-public.git
   cd healthcare-mcp-public
   

2. Create a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Set up environment variables (optional):

   # Create .env file from example
   cp .env.example .env
   # Edit .env with your API keys (optional)
   

5. Run the server:

   python run.py
   

Usage

Running in Different Transport Modes

• stdio mode (default, for Cline):

  python run.py
  

• HTTP/SSE mode (for web clients):

  python run.py --http
  

Testing the Tools

You can test the MCP tools individually or all together:

# Run all tests
python -m tests.run_tests

# Test individual tools
python -m tests.run_tests --fda        # Test FDA drug lookup
python -m tests.run_tests --pubmed     # Test PubMed search
python -m tests.run_tests --health     # Test Health Topics
python -m tests.run_tests --trials     # Test Clinical Trials search
python -m tests.run_tests --icd        # Test ICD-10 code lookup

# Test the HTTP server
python -m tests.run_tests --server

API Reference

FDA Drug Lookup

fda_drug_lookup(drug_name: str, search_type: str = "general")

Parameters:

• drug_name: Name of the drug to search for
• search_type: Type of information to retrieve
  • general: Basic drug information (default)
  • label: Drug labeling information
  • adverse_events: Reported adverse events

PubMed Search

pubmed_search(query: str, max_results: int = 5, date_range: str = "")

Parameters:

• query: Search query for medical literature
• max_results: Maximum number of results to return (default: 5)
• date_range: Limit to articles published within years (e.g. '5' for last 5 years)

Health Topics

health_topics(topic: str, language: str = "en")

Parameters:

• topic: Health topic to search for information
• language: Language for content (en or es, default: en)

Clinical Trials Search

clinical_trials_search(condition: str, status: str = "recruiting", max_results: int = 10)

Parameters:

• condition: Medical condition or disease to search for
• status: Trial status (recruiting, completed, active, not_recruiting, or all)
• max_results: Maximum number of results to return

ICD-10 Code Lookup

lookup_icd_code(code: str = None, description: str = None, max_results: int = 10)

Parameters:

• code: ICD-10 code to look up (optional if description is provided)
• description: Medical condition description to search for (optional if code is provided)
• max_results: Maximum number of results to return

Data Sources

This MCP server utilizes several publicly available healthcare APIs:

• FDA OpenFDA API
• PubMed E-utilities API
• Health.gov API
• ClinicalTrials.gov API
• NLM Clinical Table Search Service for ICD-10-CM

Premium Version

This is the free version of Healthcare MCP Server with usage limits. For advanced features and higher usage limits, check out our premium version:

• Unlimited API calls
• Advanced healthcare data tools
• Custom integrations
• Priority support

Visit healthcaremcp.com to learn more and sign up for a premium account.

License

MIT License