Clinical Trials MCP 服务器

English | 简体中文

基于 ClinicalTrials.gov API v2 的 MCP 服务器，提供智能临床试验查询功能，默认优化为查找相关的、正在招募的试验。

功能特性

• 🔍 智能搜索：支持关键词、疾病类型、地理位置搜索
• 📍 地理定位：支持国家、城市或地理坐标查询
• ⏰ 时间过滤：默认查询过去3个月（招募中的试验）
• 📊 详细信息：包含 PI、联系方式、入选标准的完整试验详情
• 🌐 双语支持：支持中英文查询

快速开始

无需安装！直接运行：

npx xiaoyibao-clinical-trials

MCP 客户端配置

添加到你的 MCP 客户端设置：

使用 npx（推荐）

{
  "mcpServers": {
    "clinical-trials": {
      "command": "npx",
      "args": ["-y", "xiaoyibao-clinical-trials"]
    }
  }
}

使用本地安装

npm install -g xiaoyibao-clinical-trials

{
  "mcpServers": {
    "clinical-trials": {
      "command": "xiaoyibao-clinical-trials"
    }
  }
}

可用工具

1. search_clinical_trials

搜索临床试验，使用智能默认值。

默认行为：

• 状态：RECRUITING（正在招募）
• 时间：过去3个月（更有可能开放）
• 结果：30个最相关试验，按最近更新排序

参数：

• keywords (string): 关键词，如 "KRAS G12D"、"PD-1"、"Pembrolizumab"
• condition (string): 疾病/状况，如 "胰腺癌"、"Pancreatic Cancer"
• country (string): 国家名称，如 "中国"、"China"、"United States"
• city (string): 城市名称，如 "北京"、"上海"、"New York"
• months (number): 时间范围（月），默认：3
• status (string): 招募状态，默认："RECRUITING"
• pageSize (number): 每页结果数，默认：30，最大：100
• pageToken (string): 分页令牌

示例：

{
  "keywords": "KRAS G12D",
  "condition": "胰腺癌",
  "country": "中国"
}

2. get_trial_details

获取全面的试验详情，包括：

• 主要研究者（PI）信息
• 各城市医院地点
• 联系方式（电话、邮箱）
• 详细研究介绍
• 入选/排除标准
• 主要/次要结果指标

参数：

• nctId (string, 必需): NCT 编号，如 "NCT04852770"

示例：

{
  "nctId": "NCT04852770"
}

3. search_by_location

根据地理坐标搜索试验。

参数：

• latitude (number, 必需): 纬度
• longitude (number, 必需): 经度
• radius (number): 搜索半径（英里），默认：50
• condition (string): 疾病/状况（可选）
• keywords (string): 关键词（可选）
• status (string): 招募状态，默认："RECRUITING"
• months (number): 时间范围，默认：3
• pageSize (number): 每页结果数，默认：30

示例：

{
  "latitude": 39.9042,
  "longitude": 116.4074,
  "radius": 50,
  "condition": "肺癌"
}

输出格式

所有响应均为 JSON 格式，优化供 LLM 处理。

搜索结果

{
  "totalCount": 13,
  "count": 13,
  "studies": [
    {
      "nctId": "NCT06218914",
      "title": "Phase 1 Study to Investigate TCRTs KRAS Mutation...",
      "status": "RECRUITING",
      "conditions": ["Pancreatic Cancer", "KRAS G12D"],
      "interventions": [{"type": "Drug", "name": "NT-112"}],
      "sponsor": "AstraZeneca",
      "studyType": "INTERVENTIONAL",
      "phase": ["PHASE1"],
      "lastUpdate": "2024-10-15"
    }
  ]
}

试验详情

包含所有搜索字段，以及：

• investigators[] - PI 和研究团队
• overallOfficials[] - 研究负责人
• centralContacts[] - 全局联系信息（电话、邮箱）
• locations[] - 所有医院地点及当地联系人
• locationsSummary - 统计信息（国家、城市、总地点数）
• eligibility - 详细入选/排除标准
• primaryOutcomes[], secondaryOutcomes[] - 研究终点
• briefSummary, detailedDescription - 完整研究描述

API 参考

• ClinicalTrials.gov API 文档
• 构建复杂查询
• 搜索区域

开发

# 克隆仓库
git clone git@github.com:PancrePal-xiaoyibao/xiaoyibao-clinical-trials-mcp-server.git
cd xiaoyibao-clinical-trials-mcp-server

# 安装依赖
npm install

# 运行测试
npm test

# 启动服务器
npm start

发布到 npm

# 登录 npm
npm login

# 发布包
npm publish

许可证

MIT

贡献

欢迎贡献！请提交 issue 或 pull request。
欢迎贡献！请提交 issue 或 pull request。
特别感谢 小胰宝-Pancrepal 与 小X宝社区 的贡献与开发，用 ❤️ 与 AI 支持癌症/罕见病患者及其家庭！