Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Doctor Claude I have a headache and fever, what could it be?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that:
Provides Claude Code with access to peer-reviewed medical information from trusted sources: MedlinePlus and StatPearls (NCBI).
Acts as an unliscensed diagnostic medical expert.
Clone and navigate to the repository:
git clone https://github.com/gholtzap/doctor-claude.git
cd doctor-claudeRun the setup script:
./setup.shClone and navigate to the repository:
git clone https://github.com/gholtzap/doctor-claude.git
cd doctor-claudeInstall dependencies and build:
npm install
npm run buildAdd to Claude Code (must be run from the repository directory):
claude mcp add --transport stdio doctor-claude -- node $(pwd)/build/index.jsImportant: Make sure you're in the doctor-claude directory when running the above command.
(Optional) Set your patient profile (see below)
Launch Claude Code and type /doctor-claude:diagnostic_consultation
Related MCP server: StatPearls MCP Server
Create a patient-profile.json file in your working directory to provide personalized medical context during consultations. This file is automatically loaded when you start a diagnostic consultation.
Example file (patient-profile.json):
{
"age": 45,
"sex": "female",
"weight": { "value": 150, "unit": "lbs" },
"height": { "value": 65, "unit": "in" },
"chronicConditions": ["Type 2 Diabetes", "Hypertension"],
"medications": ["Metformin 500mg twice daily", "Lisinopril 10mg daily"],
"allergies": ["Penicillin", "Shellfish"],
"surgicalHistory": ["Appendectomy (2015)"],
"familyHistory": ["Mother: Breast cancer", "Father: Heart disease"]
}All fields are optional. Copy patient-profile.example.json to patient-profile.json and customize it.
Privacy: Your profile has the same privacy level as sending it in a claude chat. I, the developer, have 0 access to any profiles, as they are stored locally on your machine.
Engages Claude in a systematic medical consultation process. Automatically includes your patient profile if available.
Important: This is for educational purposes only. If you are feeling unwell, see a doctor.
Usage in Claude Code:
/doctor-claude:diagnostic_consultationCalculate clinical decision rule scores to help assess disease severity, risk stratification, and guide clinical decision-making. Supports multiple evidence-based calculators: CURB-65 (pneumonia severity), Centor Score (strep throat probability), Wells DVT (deep vein thrombosis risk), Wells PE (pulmonary embolism risk), HEART Score (chest pain cardiac risk), CHA2DS2-VASc (stroke risk in atrial fibrillation), GCS (Glasgow Coma Scale for consciousness assessment), qSOFA (sepsis screening), Alvarado Score (appendicitis), Glasgow-Blatchford Score (upper GI bleeding risk), NIHSS (NIH Stroke Scale for stroke severity), SOFA (Sequential Organ Failure Assessment), PERC (Pulmonary Embolism Rule-out Criteria), TIMI (Thrombolysis in Myocardial Infarction Risk Score), MELD (Model for End-Stage Liver Disease), GAD-7 (Generalized Anxiety Disorder-7). These tools help determine appropriate level of care (outpatient vs hospital) and testing strategies. This tool provides EDUCATIONAL information only - all clinical decisions must be made by qualified healthcare providers.
Inputs: inputs (required), calculator (required).
Delete the saved patient profile information.
Inputs: no named parameters.
Fetch and parse the full content of a medical article from MedlinePlus or StatPearls. Only URLs from medlineplus.gov and ncbi.nlm.nih.gov are allowed for security. This tool provides EDUCATIONAL information only - not medical advice, diagnoses, or treatment recommendations.
Inputs: url (required).
Retrieve the saved patient profile information. Returns null if no profile has been saved.
Inputs: no named parameters.
Search for peer-reviewed medical information from MedlinePlus and StatPearls (NCBI). Returns a list of relevant articles with titles, URLs, and descriptions. IMPORTANT: Use simple, focused queries with 1-3 key medical terms for best results. Avoid overly complex multi-word queries. If searching for specific patterns or presentations, use the core condition/topic (e.g., "child abuse burns" instead of "geometric patterned skin lesions burns infants child abuse"). The tool will automatically try simpler queries if the initial search returns no results. This tool provides EDUCATIONAL information only - not medical advice, diagnoses, or treatment recommendations.
Inputs: query (required), source.
Save patient profile information (age, weight, height, chronic conditions, medications, allergies, etc.). This information is stored locally and will be used to provide more personalized medical information during consultations. All fields are optional - you can provide as much or as little information as you want.
Inputs: age, sex, height, weight, +5 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool targets a distinct operation: searching for articles, fetching article content, managing patient profile (set/get/delete), and calculating clinical scores. No two tools overlap in purpose.
All tool names follow a consistent `verb_noun` pattern with snake_case (e.g., `fetch_medical_article`, `get_patient_profile`), making the action and resource clear.
With 6 tools, the server is well-scoped: 3 for patient profile management, 2 for medical information retrieval, and 1 for clinical scoring. This covers core functionality without unnecessary bloat.
The tool set covers the full lifecycle: search/fetch medical info, save/retrieve/delete patient context, and calculate relevant clinical scores. No obvious missing operations for the stated purpose.
Telehealth support for Claude, Codex and Cursor: investigate cases and connect your tools.
Free medical evidence tools: graded CliniAtlas answers, PubMed metadata and EU SmPC links.
Your lab results and health record in Claude: trends, retests, meds, conditions and symptoms.
Expert-structured medical ontologies, relationships, and evidence for AI research and reasoning.