Enhanced Medication Information MCP Server

from zesty-genius128

Provides real-time access to FDA drug data, including shortages, labeling, and recalls, via the openFDA API.

🔥🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup

Certus

A production-ready Model Context Protocol (MCP) server for real-time, authoritative medical and medication information. Certus integrates with Claude Desktop and provides live access to FDA drug data, including shortages, recalls, and labeling, via openFDA APIs.

Project Versions

This project supports both Python and JavaScript implementations of the MCP servers. You can use either version depending on your environment and preferences.

Python version: in PY_version/ (feature-complete)
JavaScript version: in JS_version/ (Node.js, feature parity for enhanced medication info)

Features (Both Versions)

Comprehensive Drug Profiles: FDA labeling, shortage status, manufacturer, and more
Real-Time Shortage Search: Live shortage data from openFDA (1,900+ records)
Recall Information: Current and historical drug recalls from FDA enforcement database
Label-Only Lookup: Retrieve only FDA-approved drug labeling
Shortage Search Guidance: Tips and strategies for finding shortage data
Market Trend Analysis: Analyze shortage patterns and risk for a drug
Batch Analysis: Assess shortages, recalls, and risk for up to 25 drugs at once

Project Structure

med_info_mcp_project/
├── JS_version/                # JavaScript/Node.js implementation
│   ├── enhanced-mcp-server.js
│   ├── openfda-client.js
│   ├── package.json
│   ├── test-client.js
│   └── ...
├── PY_version/                # Python implementation
│   ├── enhanced_mcp_server.py
│   ├── drug_server.py
│   ├── drug_features.py
│   ├── ...
├── data/                      # Data files (e.g., images for testing)
├── requirements.txt           # Python dependencies
├── README.md                  # This file
└── ...

API Endpoints & Tools

All endpoints are exposed as MCP tools and callable via Claude Desktop or programmatically. Below is a summary of each endpoint for both Python and JavaScript versions:

Enhanced Medication Info MCP Server

Tool Name	Description	Parameters	Sample Request/Response
`get_medication_profile`	Full drug profile (label + shortage)	`drug_identifier` (str, required), `identifier_type` (str, default: openfda.generic_name)	`{ "drug_identifier_requested": "lisinopril", ... }`
`search_drug_shortages`	Search for drug shortages	`search_term` (str, required), `limit` (int, default: 10)	`{ "search_term": "amoxicillin", "shortage_data": {...} }`
`search_drug_recalls`	Search for drug recalls	`search_term` (str, required), `limit` (int, default: 10)	`{ "search_term": "acetaminophen", "recall_data": {...} }`
`get_drug_label_only`	FDA label info only	`drug_identifier` (str, required), `identifier_type` (str, default: openfda.generic_name)	`{ "drug_identifier": "lisinopril", "label_data": {...} }`
`get_shortage_search_guidance`	Guidance for finding shortage info	`drug_name` (str, required)	`{ "drug_name": "clindamycin", "additional_search_strategies": {...} }`
`analyze_drug_market_trends`	Analyze shortage/market trends	`drug_name` (str, required), `months_back` (int, default: 12)	`{ "drug_analyzed": "amoxicillin", "trend_data": {...} }`
`batch_drug_analysis`	Batch analysis for multiple drugs	`drug_list` (list of str, max 25), `include_trends` (bool, default: False)	`{ "batch_analysis": {...} }`

Drug Features MCP Server (Python only)

Tool Name	Description	Parameters	Sample Response
`check_drug_interactions`	Check for potential drug interactions	`drug1` (str, required), `drug2` (str, required), `additional_drugs` (list, optional)	`{ "interaction_analysis": {...} }`
`convert_drug_names`	Convert between generic and brand names	`drug_name` (str, required), `conversion_type` (str: "generic", "brand", "both", default: "both")	`{ "name_conversion": {...} }`
`get_adverse_events`	Get FDA adverse event reports (FAERS)	`drug_name` (str, required), `time_period` (str, default "1year"), `severity_filter` (str, default "all")	`{ "adverse_event_analysis": {...} }`

Data Sources & API Documentation

openFDA Drug Label API (docs)
Endpoint: https://api.fda.gov/drug/label.json
openFDA Drug Shortages API (docs)
Endpoint: https://api.fda.gov/drug/shortages.json
openFDA Drug Enforcement/Recalls API (docs)
Endpoint: https://api.fda.gov/drug/enforcement.json
openFDA FAERS (Adverse Events) API (docs)
Endpoint: https://api.fda.gov/drug/event.json
RxNorm API (docs)
Endpoint: https://rxnav.nlm.nih.gov/REST

Dependencies

Python: See requirements.txt
JavaScript: See JS_version/package.json

Copy & paste — that's it

cd PY_version
pip install -r ../requirements.txt
touch __init__.py

Before it works, you'll need: OPENFDA_API_KEY

Quick Start

1. Clone the Repository

# Clone and enter the project directory
$ git clone <your_repository_url>
$ cd med_info_mcp_project

Python Version Setup (`PY_version/`)

Installation

cd PY_version
pip install -r ../requirements.txt
touch __init__.py

Environment Setup (Optional)

Create a .env file for your OpenFDA API key (optional, improves rate limits):

OPENFDA_API_KEY=your_api_key_here

Get a free API key at: https://open.fda.gov/apis/authentication/

Testing

Test RxNorm client:

python3 drug_features.py

Test OpenFDA client:

python3 openfda_client.py

Claude Desktop Integration (Python)

Edit your Claude Desktop config file:

{
  "mcpServers": {
    "enhanced-medication-info": {
      "command": "python3",
      "args": ["/full/path/to/PY_version/enhanced_mcp_server.py"]
    },
    "drug-features": {
      "command": "python3",
      "args": ["/full/path/to/PY_version/drug_server.py"]
    }
  }
}

JavaScript Version Setup (`JS_version/`)

Prerequisites

Node.js v18 or higher

Installation

cd JS_version
npm install

Environment Setup (Optional)

Set your OpenFDA API key (optional, improves rate limits):

export OPENFDA_API_KEY="your_api_key_here"

Get a free API key at: https://open.fda.gov/apis/authentication/

Testing

Run the test client:

npm test
# or
node test-client.js

Claude Desktop Integration (JavaScript)

Edit your Claude Desktop config file:

{
  "mcpServers": {
    "enhanced-medication-info": {
      "command": "node",
      "args": ["/full/path/to/JS_version/enhanced-mcp-server.js"],
      "env": {
        "OPENFDA_API_KEY": "your_openfda_api_key_here"
      }
    }
  }
}

Enhanced Medication Information MCP Server

Certus

Project Versions

Features (Both Versions)

Project Structure

API Endpoints & Tools

Enhanced Medication Info MCP Server

Drug Features MCP Server (Python only)

Data Sources & API Documentation

Dependencies

Quick Start

1. Clone the Repository

Python Version Setup (`PY_version/`)

Installation

Environment Setup (Optional)

Testing

Claude Desktop Integration (Python)

JavaScript Version Setup (`JS_version/`)

Prerequisites

Installation

Environment Setup (Optional)

Testing

Claude Desktop Integration (JavaScript)

Troubleshooting & FAQ

License

Certus

Project Versions

Features (Both Versions)

Project Structure

API Endpoints & Tools

Enhanced Medication Info MCP Server

Drug Features MCP Server (Python only)

Data Sources & API Documentation

Dependencies

Quick Start

1. Clone the Repository

Python Version Setup (PY_version/)

Installation

Environment Setup (Optional)

Testing

Claude Desktop Integration (Python)

JavaScript Version Setup (JS_version/)

Prerequisites

Installation

Environment Setup (Optional)

Testing

Claude Desktop Integration (JavaScript)

Troubleshooting & FAQ

License

Python Version Setup (`PY_version/`)

JavaScript Version Setup (`JS_version/`)