╔══════════════════════════════════════════════════════════════════════════════╗
║ ║
║ ClinicalTrials.gov MCP Server - Package Contents ║
║ ║
║ Version 1.0.0 ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════╝
📦 PACKAGE STRUCTURE
════════════════════════════════════════════════════════════════════════════════
clinicaltrials-mcp-server/
│
├── 🚀 START HERE!
│ └── START_HERE.txt ...................... Welcome & orientation
│ └── QUICKSTART.md ....................... 5-minute setup guide
│
├── 🔧 CORE FILES
│ ├── clinicaltrials_mcp_server.py ........ Main MCP server (23KB)
│ ├── requirements.txt .................... Python dependencies
│ └── setup.py ............................ Installation script
│
├── 📖 DOCUMENTATION
│ ├── README.md ........................... Complete documentation (8KB)
│ ├── PROJECT_SUMMARY.md .................. Project overview (8KB)
│ ├── QUICK_REFERENCE.md .................. Query patterns (8KB)
│ ├── FIELD_REFERENCE.md .................. API field guide (12KB)
│ └── CONFIGURATION.md .................... Setup instructions (7KB)
│
├── 🧪 TESTING & EXAMPLES
│ ├── test_server.py ...................... Validation tests (6KB)
│ └── example_usage.py .................... Working examples (5KB)
│
└── 📄 LEGAL
└── LICENSE ............................. MIT License
═══════════════════════════════════════════════════════════════════════════════
FILE GUIDE
═══════════════════════════════════════════════════════════════════════════════
┌─ START HERE ────────────────────────────────────────────────────────────────┐
│ │
│ START_HERE.txt │
│ ├─ What's in this package │
│ ├─ Quick start steps │
│ ├─ Where to begin │
│ └─ File descriptions │
│ │
│ QUICKSTART.md ⭐ READ THIS FIRST │
│ ├─ Installation steps │
│ ├─ Claude Desktop setup │
│ ├─ First queries to try │
│ ├─ Common issues solved │
│ └─ Tips for best results │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ CORE IMPLEMENTATION ───────────────────────────────────────────────────────┐
│ │
│ clinicaltrials_mcp_server.py [Main Server - 23KB] │
│ ├─ ClinicalTrialsAPI class │
│ │ ├─ search_studies() - Search with multiple criteria │
│ │ ├─ get_study() - Get detailed study info │
│ │ └─ get_study_statistics() - Aggregate stats │
│ │ │
│ ├─ MCP Tools │
│ │ ├─ search_clinical_trials - Find trials │
│ │ ├─ get_clinical_trial - Get trial details │
│ │ └─ get_trial_statistics - Get statistics │
│ │ │
│ └─ Features │
│ ├─ Async/await pattern │
│ ├─ Error handling │
│ ├─ Response formatting │
│ └─ Pagination support │
│ │
│ requirements.txt │
│ ├─ mcp>=1.0.0 │
│ ├─ httpx>=0.27.0 │
│ └─ pydantic>=2.0.0 │
│ │
│ setup.py │
│ └─ Package installation configuration │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ DOCUMENTATION ─────────────────────────────────────────────────────────────┐
│ │
│ README.md [Complete Documentation - 8KB] │
│ ├─ Overview & features │
│ ├─ Installation instructions │
│ ├─ Configuration guide │
│ ├─ Tool descriptions │
│ ├─ Common use cases │
│ ├─ Data structure details │
│ ├─ Troubleshooting guide │
│ └─ API references │
│ │
│ PROJECT_SUMMARY.md [Project Overview - 8KB] │
│ ├─ What's included │
│ ├─ Key features │
│ ├─ Technical details │
│ ├─ Use cases │
│ ├─ Integration examples │
│ ├─ Best practices │
│ └─ Changelog │
│ │
│ QUICK_REFERENCE.md [Query Patterns - 8KB] │
│ ├─ Basic searches │
│ │ ├─ By condition │
│ │ ├─ By intervention │
│ │ └─ By location │
│ ├─ Status filtering │
│ ├─ Advanced searches │
│ ├─ Research use cases │
│ ├─ Tips & best practices │
│ └─ Common gotchas │
│ │
│ FIELD_REFERENCE.md [API Fields - 12KB] │
│ ├─ Complete data structure │
│ ├─ All modules explained │
│ │ ├─ identificationModule │
│ │ ├─ statusModule │
│ │ ├─ descriptionModule │
│ │ ├─ conditionsModule │
│ │ ├─ designModule │
│ │ ├─ armsInterventionsModule │
│ │ ├─ outcomesModule │
│ │ ├─ eligibilityModule │
│ │ └─ contactsLocationsModule │
│ ├─ Search parameters │
│ ├─ Enumeration values │
│ └─ Field selection examples │
│ │
│ CONFIGURATION.md [Setup Guide - 7KB] │
│ ├─ Claude Desktop │
│ │ ├─ macOS setup │
│ │ └─ Windows setup │
│ ├─ VS Code Cline │
│ ├─ Continue.dev │
│ ├─ Custom Python clients │
│ ├─ Environment variables │
│ ├─ Advanced configuration │
│ └─ Production deployment │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ TESTING & EXAMPLES ────────────────────────────────────────────────────────┐
│ │
│ test_server.py [Validation Tests - 6KB] │
│ ├─ Import tests │
│ ├─ API client creation │
│ ├─ Study formatting │
│ ├─ Server initialization │
│ ├─ Tool definitions │
│ └─ URL construction │
│ │
│ example_usage.py [Working Examples - 5KB] │
│ ├─ Basic condition search │
│ ├─ Intervention search │
│ ├─ Sponsor search │
│ ├─ Location search │
│ ├─ Specific trial details │
│ ├─ Complex multi-criteria │
│ └─ Statistics retrieval │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
═══════════════════════════════════════════════════════════════════════════════
QUICK REFERENCE
═══════════════════════════════════════════════════════════════════════════════
🎯 SETUP WORKFLOW
─────────────────────────────────────────────────────────────────────────────
1. Read START_HERE.txt or QUICKSTART.md
2. Install: pip install -r requirements.txt
3. Test: python3 test_server.py
4. Configure Claude Desktop (see CONFIGURATION.md)
5. Try example queries
💡 COMMON TASKS
─────────────────────────────────────────────────────────────────────────────
Find search examples → QUICK_REFERENCE.md
Setup for Claude Desktop → QUICKSTART.md or CONFIGURATION.md
Understand data fields → FIELD_REFERENCE.md
Troubleshoot issues → README.md (Troubleshooting section)
See working code → example_usage.py
Validate installation → test_server.py
📊 WHAT YOU GET
─────────────────────────────────────────────────────────────────────────────
✓ Search 400,000+ clinical trials
✓ Filter by condition, intervention, location, status
✓ Get complete study details
✓ Access eligibility criteria
✓ Find contact information
✓ View study locations
✓ See results (when available)
🔍 SEARCH EXAMPLES
─────────────────────────────────────────────────────────────────────────────
By condition: "Find recruiting depression trials"
By drug: "Find trials using Pembrolizumab"
By location: "Find diabetes trials in Boston"
By sponsor: "Find NIMH-sponsored trials"
Get details: "Get details for trial NCT04267848"
🛠️ TECHNICAL SPECS
─────────────────────────────────────────────────────────────────────────────
Language: Python 3.10+
Framework: Model Context Protocol (MCP) 1.0+
API: ClinicalTrials.gov API v2
Transport: stdio
Dependencies: mcp, httpx, pydantic
Total Size: ~90KB (13 files)
📞 SUPPORT
─────────────────────────────────────────────────────────────────────────────
Setup issues → QUICKSTART.md
Configuration help → CONFIGURATION.md
Query help → QUICK_REFERENCE.md
API details → FIELD_REFERENCE.md
Troubleshooting → README.md
═══════════════════════════════════════════════════════════════════════════════
Ready to begin? Open START_HERE.txt or QUICKSTART.md
═══════════════════════════════════════════════════════════════════════════════
Built for: Deliberate AI
Version: 1.0.0
Date: December 2, 2025
License: MIT
