Supports loading environment variables from .env files for configuration, particularly for storing optional API keys used by the healthcare data services.
Used for version control and distribution of the Healthcare MCP Server codebase, enabling users to clone the repository for manual installation.
Hosts the Healthcare MCP Server repository, allowing users to access and clone the codebase for installation and deployment.
Provides search functionality for medical literature from PubMed's database of scientific articles, allowing retrieval of research papers with customizable result limits and date range filtering.
Serves as the runtime environment for the Healthcare MCP Server, supporting both command-line execution and virtual environment management.
Healthcare MCP Server
A Model Context Protocol (MCP) server providing AI assistants with access to healthcare data and medical information tools.
Overview
Healthcare MCP Server is a specialized Node.js server that implements the Model Context Protocol (MCP) to provide AI assistants with access to healthcare data and medical information tools. It enables AI models to retrieve accurate, up-to-date medical information from authoritative sources. This repository provides a single DXT package containing the complete Node.js implementation.
Related MCP server: MCP Toolkit
DXT Extension
This repository includes a packaged DXT (Desktop Extension) file for easy installation in compatible development environments. Download healthcare-mcp.dxt for one-click installation.
Features
FDA Drug Information: Search and retrieve comprehensive drug information from the FDA database (improved response parsing)
PubMed Research: Search medical literature from PubMed's database of scientific articles
Health Topics: Access evidence-based health information from Health.gov (updated to API v4)
Clinical Trials: Search for ongoing and completed clinical trials (updated API parameters)
Medical Terminology: Look up ICD-10 codes and medical terminology definitions
medRxiv Search: Search for pre-print articles on medRxiv
Medical Calculator: Calculate Body Mass Index (BMI)
NCBI Bookshelf Search: Search the NCBI Bookshelf for biomedical books and documents
DICOM Metadata Extraction: Extract metadata from a DICOM file
Caching: Efficient caching system with connection pooling to reduce API calls and improve performance
Usage Tracking: Anonymous usage tracking to monitor API usage
Error Handling: Robust error handling and logging
Multiple Interfaces: Support for both stdio (for CLI) and HTTP/SSE interfaces
API Documentation: Interactive API documentation with Swagger UI
Comprehensive Testing: Extensive test suite with Node.js testing and API verification
Installation
Option 1: DXT Extension (Recommended)
Download
healthcare-mcp.dxtfrom this repositoryOpen with your compatible MCP client (such as Claude Desktop)
Follow the installation prompts
Configure optional settings through the GUI
Option 2: Installing via Smithery
To install Healthcare Data and Medical Information Server for Claude Desktop automatically via Smithery:
Option 3: npm Installation
Install the package:
npm install healthcare-mcpRun the server:
npx healthcare-mcp
Option 4: Manual Installation from Source
Clone the repository:
git clone https://github.com/Cicatriiz/healthcare-mcp-public.git cd healthcare-mcp-public/serverInstall dependencies:
npm installSet up environment variables (optional):
# Create .env file from example cp .env.example .env # Edit .env with your API keys (optional)Run the server:
npm start
Usage
Running the Server
stdio mode (default, for MCP clients):
npm startHTTP/SSE mode (for web clients):
npm run server:http
Testing the Tools
You can test the MCP tools using the built-in test scripts:
API Reference
The Healthcare MCP Server provides both a programmatic API for direct integration and a RESTful HTTP API for web clients.
RESTful API Endpoints
When running in HTTP mode, the following endpoints are available:
Health Check
Returns the status of the server and its services.
FDA Drug Lookup
Parameters:
drug_name: Name of the drug to search forsearch_type: Type of information to retrievegeneral: Basic drug information (default)label: Drug labeling informationadverse_events: Reported adverse events
Example Response:
PubMed Search
Parameters:
query: Search query for medical literaturemax_results: Maximum number of results to return (default: 5, max: 50)date_range: Limit to articles published within years (e.g. '5' for last 5 years)
Example Response:
Health Topics
Parameters:
topic: Health topic to search for informationlanguage: Language for content (en or es, default: en)
Example Response:
Clinical Trials Search
Parameters:
condition: Medical condition or disease to search forstatus: Trial status (recruiting, completed, active, not_recruiting, or all)max_results: Maximum number of results to return (default: 10, max: 100)
Example Response:
ICD-10 Code Lookup
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 (default: 10, max: 50)
Example Response:
Generic Tool Execution
Request Body:
MCP Tools
When using the MCP server through compatible clients, the following tools are available:
FDA Drug Lookup
Parameters:
drug_name: Name of the drug to search forsearch_type: Type of information to retrievegeneral: Basic drug information (default)label: Drug labeling informationadverse_events: Reported adverse events
PubMed Search
Parameters:
query: Search query for medical literaturemax_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
Parameters:
topic: Health topic to search for informationlanguage: Language for content (en or es, default: en)
Clinical Trials Search
Parameters:
condition: Medical condition or disease to search forstatus: Trial status (recruiting, completed, active, not_recruiting, or all)max_results: Maximum number of results to return
ICD-10 Code Lookup
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
medRxiv Search
Parameters:
query: Search query for medRxiv articlesmax_results: Maximum number of results to return
Calculate BMI
Parameters:
height_meters: Height in metersweight_kg: Weight in kilograms
NCBI Bookshelf Search
Parameters:
query: Search query for NCBI Bookshelfmax_results: Maximum number of results to return
Extract DICOM Metadata
Parameters:
file_path: Path to the DICOM file
Data Sources
This MCP server utilizes several publicly available healthcare APIs:
License
MIT License