Skip to main content
Glama
README.md
# Doctor Claude

An MCP server that:
1. Provides Claude Code with access to peer-reviewed medical information from trusted sources: MedlinePlus and StatPearls (NCBI).
2. Acts as an unliscensed diagnostic medical expert.

## Installation

### Quick Setup (Recommended)

1. Clone and navigate to the repository:
```bash
git clone https://github.com/gholtzap/doctor-claude.git
cd doctor-claude
```

2. Run the setup script:
```bash
./setup.sh
```

### Manual Setup

1. Clone and navigate to the repository:
```bash
git clone https://github.com/gholtzap/doctor-claude.git
cd doctor-claude
```

2. Install dependencies and build:
```bash
npm install
npm run build
```

3. Add to Claude Code (must be run from the repository directory):
```bash
claude mcp add --transport stdio doctor-claude -- node $(pwd)/build/index.js
```
**Important:** Make sure you're in the `doctor-claude` directory when running the above command.

### Next Steps

1. (Optional) Set your patient profile (see below)
2. Launch Claude Code and type `/doctor-claude:diagnostic_consultation`

## Patient Profile

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`):**
```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.

## Prompts

### diagnostic_consultation

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:**
```bash
/doctor-claude:diagnostic_consultation
```

TDQS

A4.2/5.0

Scored across 6 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness5/5

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.

Maintenance

ActivityInactive
ResponsivenessNo issues