非官方ClinicalTrials.gov MCP服务器
一个专门的模型上下文协议(MCP)服务器,通过两个强大的临床试验研究和发现工具提供对ClinicalTrials.gov数据的全面访问。
特性
- 临床试验检索 -使用高级筛选功能搜索400000多个临床试验
- 复杂查询支持 -具有布尔运算符、字段定位和日期范围的高级搜索表达式
- OR操作员支持 -在所有参数中使用OR语法(例如,“肥胖或减肥”、“招募或active_not_recruiting”)
- 学期建议 -从ClinicalTrials.gov词典中获取准确的术语
- 高级过滤 -按阶段、状态、人口统计、位置、赞助商等进行筛选
- 分页支持 -使用基于标记的分页导航大型结果集
用法
{
"mcpServers": [
"clinicaltrials-mcp-server": {
"command": "node",
"args": ["/path/to/clinicaltrials-mcp-server/build/index.js"],
"env": {}
}
]
}可用工具
ct_gov_studies -统一临床试验.gov工具
一个综合工具,将所有ClinicalTrials.gov功能整合到一个具有三种操作模式的单一界面中。 更新了高级复杂查询支持和增强的分页功能。
*该工具在其模式中包括18个以上的综合示例,涵盖了基本搜索、复杂查询、分页、建议和详细的研究检索。*
方法参数(必填)
method-操作类型:search,suggest,get
搜索方法(method: "search")
使用全面的筛选选项搜索临床试验(35个参数涵盖所有ClinicalTrials.gov搜索功能):
核心搜索参数
condition-医疗状况(例如,“2型糖尿病”)。使用OR运算符组合多个条件(例如,“肥胖或体重减轻”)term-其他搜索词(例如“高血压”)。使用OR运算符组合多个术语(例如“糖尿病或高血压”)intervention-治疗/药物名称(例如“阿司匹林”)。使用OR运算符组合多种干预措施(例如“semaglutide OR liraglutide”)titles-在研究标题/缩略语中搜索。使用OR运算符组合多个术语outc-在结果中搜索。使用OR运算符组合多个术语id-按研究ID、NCT ID或首字母缩略词搜索。使用OR运算符组合多个IDcomplexQuery-使用CT.gov运算符的高级搜索表达式
复杂查询支持
使用高级CT.gov搜索运算符进行复杂查询:
布尔运算符 AND、OR、NOT括号()用于分组\ 上下文运算符: AREA\[字段\](搜索特定字段),search\[上下文\](嵌套搜索上下文)\ 范围操作员: RANGE\[开始,结束\](日期/数字范围,对开放范围使用MAX/MIN)\ 源操作员: 扩展\[源\](概念扩展),倾斜\[场\](倾斜搜索)\ 特种作业人员: 缺少(空值),精确短语的引号
可用区域字段: 阶段、标准、设计分配、设计屏蔽、设计干预模型、设计主要目的、研究类型、干预类型、主要赞助商类别、干预名称、设计观察模型、设计时间视角、设计Who屏蔽、研究首次发布日期等。
OR操作员支持
所有基于文本和枚举的参数现在都支持OR运算符,用于强大的多值搜索:
支持OR的文本参数:
condition:"obesity OR weight loss"-查找多种相关疾病的研究intervention:"semaglutide OR liraglutide OR tirzepatide"-一次搜索多种药物term:"diabetes OR hypertension"-组合多个搜索词location:"US OR Canada"-同时搜索多个位置lead:"Pfizer OR Merck"-查找来自多个赞助商的研究
带OR支持的枚举参数:
status:"recruiting OR active_not_recruiting"-查找所有正在进行的研究funderType:"nih OR industry"-整合资金来源ages:"child OR adult"-针对多个年龄段studyType:"interventional OR observational"-跨研究类型搜索allocation:"randomized OR nonrandomized"-包含多种设计masking:"double OR triple"-寻找各种致盲方法
为什么使用OR运算符:
- 结果增加:
"obesity"(438项研究)vs"obesity OR weight loss"(479项研究) - 精确定位:无需多次查询即可搜索相关条件
- 效率:一次搜索,而不是多次单独搜索
- 全面覆盖:确保你不会错过相关研究
高级过滤
phase-临床试验阶段(阶段0、阶段1、阶段2、阶段3、阶段4、早期阶段1、NA)status-招聘状态,包括扩大准入计划。支持OR组合(例如,“招聘或active_not_recruiting”)ages-年龄组(儿童、成人、老年人_成人)或自定义范围。支持OR组合(例如,“儿童或成人”)sex-性别过滤器(全部、m、f)location-地理过滤(城市、州、国家)。支持OR组合(例如,“德克萨斯州OR加利福尼亚州”)lead-牵头赞助组织。支持OR组合(例如“辉瑞或默克”)healthy-接受健康志愿者的研究studyType-研究方法(干预性、观察性、扩大可及性)。支持OR组合(例如“介入OR观察”)funderType-资金来源(美国国立卫生研究院、联邦、行业、其他)。支持OR组合(例如,“nih OR行业”)results-有/没有已发表结果的研究docs-文件可用性(方案、统计计划、同意书)violation-FDA合规/违规过滤
研究设计筛选
allocation-随机化方法(随机、非随机、na)masking-百叶窗设计(无、单、双、三、四)assignment-干预策略(单一、平行、交叉、析因、序贯)purpose-研究目的(治疗、预防、诊断、支持、筛查)model-观察性研究设计(队列、病例对照、仅病例、病例交叉)interventionType-干预类型(药物、设备、生物、程序、行为)timePerspective-研究时间视角(回顾性、前瞻性、横断面)whoMasked-谁失明(参与者、护理人员、研究人员、结果评估员)
时间滤波
start-研究开始日期范围primComp-主要完成日期范围firstPost-研究首次发布日期范围resFirstPost-首次发布结果的日期范围lastUpdPost-上次更新发布日期范围studyComp-研究完成日期范围
结果控制和分页
sort-按相关性、日期、注册计数排序limit-结果数(1-100,默认值:10)-已弃用:改用pageSizepageSize-每页结果数(1-100,默认值:10)pageToken-分页令牌(来自上一个nextPageToken)countTotal-是否在响应中包含总计数(默认值:true)
示例用法
基本搜索:
{
"method": "search",
"condition": "Heart Failure",
"phase": "PHASE2",
"status": "recruiting",
"ages": "adult",
"location": "United States",
"allocation": "randomized",
"masking": "double",
"purpose": "treatment",
"pageSize": 20
}复杂查询示例:
{
"method": "search",
"complexQuery": "(diabetes OR \"metabolic syndrome\") AND AREA[Phase]PHASE2",
"pageSize": 10
}{
"method": "search",
"complexQuery": "AREA[InterventionName]aspirin AND NOT placebo",
"pageSize": 15
}{
"method": "search",
"complexQuery": "cancer AND SEARCH[Location](AREA[LocationCity]Boston AND AREA[LocationState]Massachusetts)",
"pageSize": 20
}日期范围搜索:
{
"method": "search",
"complexQuery": "diabetes AND AREA[StudyFirstPostDate]RANGE[2020-01-01, MAX]",
"pageSize": 25
}分页示例:
{
"method": "search",
"condition": "diabetes",
"pageSize": 50,
"pageToken": "eyJ0b2tlbiI6ImFiYzEyMyIsInBhZ2UiOjJ9",
"countTotal": true
}高级筛选:
{
"method": "search",
"condition": "cancer",
"interventionType": "drug",
"sex": "f",
"studyType": "interventional",
"pageSize": 15
}OR操作员示例:
{
"method": "search",
"condition": "obesity OR weight loss",
"intervention": "semaglutide OR liraglutide OR tirzepatide",
"status": "recruiting OR active_not_recruiting",
"location": "US OR Canada",
"pageSize": 20
}{
"method": "search",
"condition": "diabetes OR hypertension",
"funderType": "nih OR industry",
"ages": "adult OR older_adult",
"studyType": "interventional OR observational",
"pageSize": 25
}{
"method": "search",
"intervention": "aspirin OR ibuprofen OR acetaminophen",
"phase": "PHASE2",
"allocation": "randomized OR nonrandomized",
"masking": "double OR triple",
"pageSize": 15
}建议方法(method: "suggest")
从ClinicalTrials.gov词典中获取准确的术语:
参数
input-搜索文本(至少2个字符)dictionary-词典类型:
- Condition -医疗状况和疾病 - InterventionName -治疗、药物和干预措施 - LeadSponsorName -组织和公司 - LocationFacility -医疗设施和机构
示例用法
{
"input": "diab",
"dictionary": "Condition"
}返回的建议包括:“糖尿病”、“1型糖尿病”和“2型糖尿病”等。
获取学习方法(method: "get")
通过NCT ID检索特定临床试验的综合信息:
参数
nctId(必填)-NCT编号(例如,NCT00841061、NCT04000165)format-响应格式:json,csv,json.zip,fhir.json,ris(默认值:json)markupFormat-标记格式:markdown,legacy(默认值:markdown)fields-要返回的特定字段(数组,可选)
特性
- 完整的研究信息 -方案细节、设计、结果、资格
- 多种格式 -JSON、CSV、kubectl、RIS导出选项
- 丰富的格式 -具有适当枚举格式的人类可读markdown输出
- 综合数据 -所有研究部分,包括手臂、干预措施、位置
- 错误处理 -清除无效NCT ID、重定向或缺失研究的消息
示例用法
获取完整的研究信息:
{
"nctId": "NCT00841061"
}获取具体的研究章节:
{
"nctId": "NCT04000165",
"fields": ["BriefTitle", "StatusModule", "ConditionsModule", "EligibilityModule"]
}导出为CSV:
{
"nctId": "NCT00841061",
"format": "csv"
}工作流示例
寻找糖尿病试验
- 获取准确的条件名称:
{
"method": "suggest",
"input": "diab",
"dictionary": "Condition"
}- 搜索招募第3阶段试验:
{
"method": "search",
"condition": "Diabetes Mellitus Type 2",
"phase": "PHASE3",
"status": "recruiting",
"pageSize": 10
}与手术室操作员一起寻找肥胖药物试验
- 在多个阶段查找积极肥胖/减肥药物试验:
{
"method": "search",
"condition": "obesity OR weight loss",
"interventionType": "drug",
"phase": "PHASE2",
"status": "recruiting OR active_not_recruiting",
"location": "United States",
"pageSize": 20
}*结果:美国有32项针对肥胖的活性药物试验*
- 在多种条件下搜索GLP-1受体激动剂:
{
"method": "search",
"condition": "diabetes OR obesity OR weight loss",
"intervention": "semaglutide OR liraglutide OR tirzepatide",
"status": "recruiting OR active_not_recruiting",
"pageSize": 25
}*结果:全面覆盖所有主要GLP-1试验*
高级复杂查询研究
- 查找2/3期糖尿病或代谢综合征试验:
{
"method": "search",
"complexQuery": "(diabetes OR \"metabolic syndrome\") AND (AREA[Phase]PHASE2 OR AREA[Phase]PHASE3)",
"pageSize": 15
}- 查找不包括安慰剂对照的阿司匹林研究:
{
"method": "search",
"complexQuery": "AREA[InterventionName]aspirin AND NOT placebo",
"pageSize": 20
}特定位置研究
- 在波士顿寻找癌症免疫疗法试验:
{
"method": "search",
"complexQuery": "cancer AND immunotherapy AND SEARCH[Location](AREA[LocationCity]Boston AND AREA[LocationState]Massachusetts)",
"pageSize": 10
}近期研究
- 查找自2020年以来发布的最新糖尿病研究:
{
"method": "search",
"complexQuery": "diabetes AND AREA[StudyFirstPostDate]RANGE[2020-01-01, MAX]",
"pageSize": 25
}使用分页完成研究工作流程
- 按页码搜索:
{
"method": "search",
"condition": "Cancer",
"phase": "PHASE3",
"status": "recruiting",
"pageSize": 50,
"countTotal": true
}- 使用令牌导航到下一页:
{
"method": "search",
"condition": "Cancer",
"phase": "PHASE3",
"status": "recruiting",
"pageSize": 50,
"pageToken": "eyJwYWdlIjoyLCJ0b2tlbiI6ImFiYzEyMyJ9"
}- 获取具体研究的详细信息:
{
"method": "get",
"nctId": "NCT12345678"
}这提供了全面的研究细节,包括方案设计、资格标准、联系信息和当前状态。
综合测试和查询示例
*以下部分记录了在CT.gov MCP服务器上进行的真实测试,包括所有方法和参数的25次以上成功查询。这展示了系统的强大功能,并为用户提供了大量示例。*
质量测试覆盖率概述
已执行的查询总数: 30+成功通话\ 测试方法: 全部3(搜索、建议、获取)\ 参数组合: 20+种不同配置\ 边缘案例: 8+利基场景\ 成功率: >98%(参数修复后显著改善)
搜索方法-实例
基本条件搜索
// Rare Genetic Disorders - Found 400 studies
{
"method": "search",
"condition": "rare genetic disorders",
"pageSize": 5,
"countTotal": true
}
// Results: Comprehensive coverage including Adrenomyeloneuropathy, X-Linked Hypophosphatemia, Angelman Syndrome// Migraine + Botulinum Toxin + Phase III - Found 16 studies
{
"method": "search",
"condition": "migraine",
"intervention": "botulinum toxin",
"phase": "PHASE3",
"pageSize": 3
}
// Results: Dysport® prevention studies, international multi-center trials// Psychedelic Therapy + Phase II - Found 170 studies
{
"method": "search",
"intervention": "psychedelic therapy",
"phase": "PHASE2",
"pageSize": 3
}
// Results: Psilocybin-assisted therapy, MDMA studies, emerging mental health treatments高级多参数过滤
// CAR-T Cell Therapy + Phase I + Industry Funding - Found 294 studies
{
"method": "search",
"intervention": "CAR-T cell therapy",
"phase": "PHASE1",
"funderType": "industry",
"pageSize": 3
}
// Results: Cutting-edge cancer immunotherapy trials from pharmaceutical companies// Systemic Lupus + Female + Adult + Randomized + Double-blind - Found 165 studies
{
"method": "search",
"condition": "systemic lupus erythematosus",
"sex": "f",
"ages": "adult",
"allocation": "randomized",
"masking": "double",
"pageSize": 3
}
// Results: High-quality clinical trials for autoimmune disease research最近固定的参数组合
*这些示例演示了经过校正以与CT.gov API v2一起正常工作的参数值:*
// Parkinson Disease + Older Adults + Interventional Studies - Found 3,110 studies
{
"method": "search",
"condition": "Parkinson disease",
"ages": "older_adult",
"studyType": "interventional",
"pageSize": 3
}
// Results: Land/water physiotherapy studies, brain perfusion research, motor function trials// Chronic Fatigue Syndrome in Netherlands + Recruiting - Found 1 study
{
"method": "search",
"condition": "chronic fatigue syndrome",
"location": "Netherlands",
"status": "recruiting",
"pageSize": 3
}
// Results: Mixed-methods quantitative and qualitative studies currently enrolling// Cannabis Studies in Netherlands + Completed - Found 6 studies
{
"method": "search",
"condition": "Cannabis",
"location": "Netherlands",
"status": "completed",
"pageSize": 3
}
// Results: THC safety studies, Namisol trials, behavioral disturbances in dementia// Diabetes + Observational + Adult + Recruiting - Found 553 studies
{
"method": "search",
"condition": "diabetes",
"studyType": "observational",
"ages": "adult",
"status": "recruiting",
"pageSize": 3
}
// Results: Wound healing studies, movement behavior research, macrophage metabolism// Heart Failure + Adult + Interventional - Found 4,638 studies
{
"method": "search",
"condition": "heart failure",
"ages": "adult",
"studyType": "interventional",
"pageSize": 3
}
// Results: OPCABG techniques, cardiac rehabilitation resistance training, experimental hyperketonemia复杂查询示例(高级布尔逻辑)
// CRISPR Gene Editing + Phase I - Found 65 studies
{
"method": "search",
"complexQuery": "CRISPR AND AREA[Phase]PHASE1 AND NOT placebo",
"pageSize": 3
}
// Results: NTLA-5001 for AML, COVID-19 engineered T cells, NY-ESO-1 CAR-T studies// Digital Health for Dementia (Recent Studies) - Found 21 studies
{
"method": "search",
"complexQuery": "(alzheimer OR dementia) AND AREA[StudyFirstPostDate]RANGE[2023-01-01, MAX] AND AREA[InterventionName]digital",
"pageSize": 4
}
// Results: AI-driven cognitive therapeutics, digital pain assessment, VR interventions地理和时间过滤
// Traditional Chinese Medicine in China - Found 104 studies
{
"method": "search",
"condition": "traditional Chinese medicine",
"location": "China",
"phase": "NA",
"pageSize": 3
}
// Results: Integrative pediatric treatments, Tuina therapy, gut microbiota studies建议方法-实例
医疗条件词典
// Fibromyalgia suggestions
{
"method": "suggest",
"input": "fibromyal",
"dictionary": "Condition"
}
// Results: "Fibromyalgia", "Fibromyalgia Syndrome", "Fibromyalgia (FM)",
// "Fibromyalgia, Primary", "Fibromyalgia, Secondary"// Complex endocrine condition
{
"method": "suggest",
"input": "pseudohypoparathyroid",
"dictionary": "Condition"
}
// Results: "Pseudohypoparathyroidism", "Pseudohypoparathyroidism Type 1a",
// "Pseudohypoparathyroidism Type Ia",
// "Pseudohypoparathyroidism and Pseudopseudohypoparathyroidism"干预词典
// Monoclonal antibody suggestions
{
"method": "suggest",
"input": "monoc",
"dictionary": "InterventionName"
}
// Results: "monoclonal antibody 3F8", "Monoclonal antibody",
// "monoclonal antibody therapy", "monoclonal antibody hu3S193", "Monocryl"赞助商词典
// Pharmaceutical company suggestions
{
"method": "suggest",
"input": "novart",
"dictionary": "LeadSponsorName"
}
// Results: "Novartis Pharmaceuticals", "Novartis", "Novartis Vaccines",
// "Novartis Gene Therapies", "Novartis Korea Ltd."医疗设施词典
// Academic medical centers
{
"method": "suggest",
"input": "johns hop",
"dictionary": "LocationFacility"
}
// Results: "Johns Hopkins University", "Johns Hopkins Hospital",
// "Johns Hopkins University/Sidney Kimmel Cancer Center",
// "Johns Hopkins University School of Medicine",
// "Johns Hopkins All Children's Hospital"Get方法-真实示例
综合研究详情
// Migraine Prevention Study (NCT06047457) - E-BEOND Trial
{
"method": "get",
"nctId": "NCT06047457",
"format": "json"
}
// Results: Complete Phase III study details including 90+ international locations,
// detailed inclusion/exclusion criteria, intervention protocols特定字段检索
// CAR-T Therapy Study - Basic Info Only
{
"method": "get",
"nctId": "NCT06935474",
"fields": ["NCTId", "BriefTitle", "OverallStatus", "StartDate", "Phase", "Condition"]
}
// Results: "C-CAR168 CAR T Cell Therapy for Refractory Autoimmune Disease"
// Status: Not Yet Recruiting, Phase: Phase1, Phase2历史研究访问
// MDMA-Assisted Therapy Study (2005-2011)
{
"method": "get",
"nctId": "NCT00252174"
}
// Results: Complete terminated study details for groundbreaking psychedelic research,
// including detailed eligibility criteria and intervention protocols利基和边缘案例示例
罕见条件和专业研究
// "Jumping Frenchmen of Maine" (Rare Neurological Condition) - Found 1 study
{
"method": "search",
"condition": "jumping Frenchmen of Maine",
"pageSize": 2
}
// Results: Hyperekplexia research (related startle disorder)// Space Medicine Research - Found 708 studies
{
"method": "search",
"intervention": "space medicine",
"pageSize": 2
}
// Results: Broad coverage including ICU applications, cardiac rehabilitation// Artificial Gravity + Healthy Volunteers - Found 3 studies
{
"method": "search",
"intervention": "artificial gravity",
"healthy": "y",
"pageSize": 3
}
// Results: GRACER1 centrifuge study, 60-day bedrest with cycling, space research不寻常的搜索词
// "Vampire" Boolean Query - Found 4 studies
{
"method": "search",
"complexQuery": "vampire AND NOT placebo",
"pageSize": 2
}
// Results: Medical device studies (likely related to vascular procedures)// Quantum Therapy - Found 42 studies
{
"method": "search",
"intervention": "quantum therapy",
"pageSize": 2
}
// Results: QuANTUM-R leukemia study, "Quantum Touch" pediatric anxiety research性能指标和系统能力
响应时间
- 简单搜索:\<2秒
- 复杂查询:\<3秒
- 详细研究检索:\<2秒
- 建议:\<1秒
数据覆盖亮点
- 研究总访问量:400000多项临床试验
- 国际覆盖:来自美国、加拿大、欧洲、亚洲、澳大利亚的研究
- 历史数据:21世纪初的研究仍然可用
- 当前数据:最近于2025年3月发布的研究
- 新兴领域:170项迷幻药治疗研究,294项CAR-T I期研究
搜索智能示例
- 语义匹配:“缅因州的跳跃法国人”与高屈肌症正确匹配
- 术语灵活性:医学缩写和非专业术语都有效
- 布尔逻辑:复杂和/或/非操作功能完美
- 日期范围:RANGE\[2023-01-01,MAX\]语法工作准确
演示高级用户功能
基于令牌的分页
// Initial search returns pageToken
{
"method": "search",
"complexQuery": "vampire AND NOT placebo",
"pageSize": 2,
"pageToken": "NF0g5JSGlPgsyQ" // Use token from previous response
}
// Seamlessly navigates to next page of results地理边缘案例
// Very specific geographic filtering (as expected, returns 0 results)
{
"method": "search",
"condition": "Marfan syndrome",
"location": "Iceland",
"pageSize": 3
}
// Results: 0 studies (expected for rare condition + small country)确定的最佳实践
- 先使用建议方法 用于复杂的医学术语
- 使用OR运算符 扩大搜索范围,高效查找相关研究
- 复杂的查询功能强大 用于精确瞄准
- 分页令牌是可靠的 用于浏览大型结果集
- 字段选择 in-get方法减小了响应大小
- 布尔运算符 提供显著的搜索精度
- 日期范围过滤 非常适合跟踪研究趋势
- 地理过滤 适用于特定位置的研究
- 相位滤波 对理解研究阶段至关重要
