╔══════════════════════════════════════════════════════════════════════════════╗
║ ║
║ ClinicalTrials.gov MCP Server v1.0.0 ║
║ ║
║ A Model Context Protocol Connector for Claude ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════╝
📦 WHAT'S IN THIS PACKAGE
─────────────────────────────────────────────────────────────────────────────
CORE FILES:
• clinicaltrials_mcp_server.py - Main MCP server (23KB)
• requirements.txt - Python dependencies
• setup.py - Installation script
GETTING STARTED:
⭐ QUICKSTART.md - Start here! (5-minute setup)
• README.md - Complete documentation
• PROJECT_SUMMARY.md - Project overview
DOCUMENTATION:
• CONFIGURATION.md - Setup for different clients
• QUICK_REFERENCE.md - Common query patterns
• FIELD_REFERENCE.md - Complete API field guide
TESTING & EXAMPLES:
• test_server.py - Validation tests
• example_usage.py - Working examples
OTHER:
• LICENSE - MIT License
• .gitignore - Git ignore rules
🚀 QUICK START (3 STEPS)
─────────────────────────────────────────────────────────────────────────────
1. INSTALL DEPENDENCIES:
pip install mcp httpx pydantic
2. TEST THE SERVER:
python3 test_server.py
3. CONFIGURE CLAUDE DESKTOP:
See QUICKSTART.md for detailed instructions
📖 WHERE TO START
─────────────────────────────────────────────────────────────────────────────
New Users:
1. Read QUICKSTART.md first
2. Then browse QUICK_REFERENCE.md
3. Check README.md for details
Experienced Users:
1. Install dependencies
2. Add to Claude Desktop config
3. Refer to QUICK_REFERENCE.md as needed
Developers:
1. Review README.md for architecture
2. Check FIELD_REFERENCE.md for API details
3. See example_usage.py for code samples
🎯 WHAT YOU CAN DO
─────────────────────────────────────────────────────────────────────────────
Search 400,000+ clinical trials by:
✓ Medical conditions (Depression, Diabetes, Cancer, etc.)
✓ Interventions/treatments (drugs, procedures, devices)
✓ Geographic location (cities, institutions, radius)
✓ Sponsors (NIH, pharma companies, universities)
✓ Study status (recruiting, completed, etc.)
Get detailed information:
✓ Complete study protocols
✓ Eligibility criteria
✓ Contact information
✓ Study locations
✓ Results (when available)
🔧 SYSTEM REQUIREMENTS
─────────────────────────────────────────────────────────────────────────────
Required:
• Python 3.10 or higher
• pip package manager
• Internet connection
Optional:
• Claude Desktop (for Claude integration)
• VS Code with Cline (for Cline integration)
📁 FILE DESCRIPTIONS
─────────────────────────────────────────────────────────────────────────────
clinicaltrials_mcp_server.py (23KB)
Main server implementation with 3 tools:
- search_clinical_trials: Find trials by multiple criteria
- get_clinical_trial: Get complete details for a trial
- get_trial_statistics: Get aggregate statistics
QUICKSTART.md (6.4KB)
⭐ START HERE - 5-minute setup guide with:
- Installation steps
- Configuration examples
- First queries to try
- Common issues and solutions
README.md (8.1KB)
Complete documentation including:
- Feature overview
- Installation instructions
- Configuration for different clients
- Tool descriptions
- Common use cases
- Troubleshooting
QUICK_REFERENCE.md (8.0KB)
Fast lookup guide with:
- Common search patterns
- Parameter examples
- Status values
- Research use cases
- Tips and tricks
FIELD_REFERENCE.md (12KB)
Comprehensive API documentation:
- Complete field structure
- All available parameters
- Enumeration values
- Search syntax
- Examples
CONFIGURATION.md (6.8KB)
Detailed setup instructions for:
- Claude Desktop (macOS/Windows)
- VS Code Cline extension
- Continue.dev
- Custom Python clients
- Production deployment
PROJECT_SUMMARY.md (7.7KB)
Project overview with:
- Feature summary
- Technical details
- Use cases
- Integration examples
test_server.py (5.9KB)
Test suite to validate:
- Dependencies installed
- Server functioning
- Formatting working
example_usage.py (4.5KB)
Working examples of:
- Basic searches
- Complex queries
- Getting trial details
- Using filters
💡 EXAMPLE QUERIES
─────────────────────────────────────────────────────────────────────────────
Once configured, ask Claude:
"Find recruiting clinical trials for depression"
"Get details for trial NCT04267848"
"Find diabetes trials in Boston that are recruiting"
"Show me trials sponsored by NIMH"
🆘 NEED HELP?
─────────────────────────────────────────────────────────────────────────────
1. Check QUICKSTART.md for setup issues
2. Run test_server.py to validate installation
3. See README.md troubleshooting section
4. Review example_usage.py for working code
5. Check Claude Desktop logs if integration issues
🔗 RESOURCES
─────────────────────────────────────────────────────────────────────────────
ClinicalTrials.gov: https://clinicaltrials.gov
API Documentation: https://clinicaltrials.gov/data-api/api
MCP Specification: https://spec.modelcontextprotocol.io/
📄 LICENSE
─────────────────────────────────────────────────────────────────────────────
MIT License - See LICENSE file
Note: ClinicalTrials.gov data access subject to their Terms and Conditions
📊 PROJECT INFO
─────────────────────────────────────────────────────────────────────────────
Version: 1.0.0
Created: December 2, 2025
Built for: Deliberate AI
Language: Python 3.10+
Framework: Model Context Protocol (MCP)
API: ClinicalTrials.gov API v2
License: MIT
═══════════════════════════════════════════════════════════════════════════════
Ready to get started? Open QUICKSTART.md!
═══════════════════════════════════════════════════════════════════════════════
