Clinical Trials MCP Server

English | 简体中文

MCP server for querying clinical trials from ClinicalTrials.gov API v2. Provides intelligent search with defaults optimized for finding relevant, currently recruiting trials.

功能特性 Features

• 🔍 Smart Search: Keywords, disease type, location-based search

• 📍 Geographic: Search by country, city, or coordinates

• ⏰ Time Filters: Default to past 3 months (recruiting trials)

• 📊 Detailed Info: Complete trial details including PI, contacts, eligibility

• 🌐 Bilingual: Supports Chinese and English queries

Quick Start with npx

No installation required! Run directly:

MCP Client Configuration

Add to your MCP client settings:

Using npx (Recommended)

Using local installation

Available Tools

1. search_clinical_trials

Search for clinical trials with intelligent defaults.

Default Behavior:

• Status: RECRUITING (currently recruiting)

• Time: Past 3 months (trials more likely to be open)

• Results: 30 most relevant trials, sorted by recent updates

Parameters:

• keywords (string): Keywords like "KRAS G12D", "PD-1", "Pembrolizumab"

• condition (string): Disease/condition like "Pancreatic Cancer", "肠癌"

• country (string): Country name like "China", "United States", "中国"

• city (string): City name like "Beijing", "上海", "New York"

• months (number): Time range in months (default: 3)

• status (string): Recruitment status (default: "RECRUITING")

• pageSize (number): Results per page (default: 30, max: 100)

• pageToken (string): Pagination token

Example:

2. get_trial_details

Get comprehensive trial details including:

• Principal Investigators (PI) information

• Hospital locations by city

• Contact details (phone, email)

• Detailed study description

• Eligibility criteria (inclusion/exclusion)

• Primary/secondary outcomes

Parameters:

• nctId (string, required): NCT number like "NCT04852770"

Example:

3. search_by_location

Search trials by geographic coordinates.

Parameters:

• latitude (number, required): Latitude

• longitude (number, required): Longitude

• radius (number): Search radius in miles (default: 50)

• condition (string): Disease/condition (optional)

• keywords (string): Keywords (optional)

• status (string): Recruitment status (default: "RECRUITING")

• months (number): Time range (default: 3)

• pageSize (number): Results per page (default: 30)

Example:

Output Format

All responses are in JSON format, optimized for LLM processing.

Search Results

Trial Details

Includes all search fields plus:

• investigators[] - PI and research team

• overallOfficials[] - Study officials

• centralContacts[] - Global contact info (phone, email)

• locations[] - All hospital sites with local contacts

• locationsSummary - Statistics (countries, cities, total sites)

• eligibility - Detailed inclusion/exclusion criteria

• primaryOutcomes[], secondaryOutcomes[] - Study endpoints

• briefSummary, detailedDescription - Full study description

API Reference

• ClinicalTrials.gov API Documentation

• Complex Query Construction

• Search Areas

Development

Publishing to npm

License

MIT

Contributing

Contributions welcome! Please open an issue or submit a pull request.

Speical thanks to the contribution & development of Xiaoyibao-Pancrepal & xiao-x-bao community to support cancer/rare disease patients and their families with ❤️ & AI！