返回市场
小医宝临床试验MCP服务器

小医宝临床试验MCP服务器

作者:PancrePal-xiaoyibao2 星标更新:2025-11-16

项目介绍

临床试验 MCP 服务器

English | 简体中文

用于从 ClinicalTrials.gov API v2 查询临床试验的 MCP 服务器。提供智能搜索,默认优化以查找相关的、当前正在招募的试验。

功能特性 Features

  • 🔍 智能搜索:关键词、疾病类型、基于位置的搜索
  • 📍 地理搜索:按国家、城市或坐标搜索
  • 时间筛选器:默认过去3个月(招募中的试验)
  • 📊 详细信息:完整的试验详情,包括主要研究者(PI)、联系方式、入选标准
  • 🌐 双语支持:支持中文和英文查询

快速开始使用 npx

无需安装!直接运行:

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(字符串):关键词如“KRAS G12D”,“PD-1”,“Pembrolizumab”
  • condition(字符串):疾病/条件如“胰腺癌”,“肠癌”
  • country(字符串):国家名称如“中国”,“美国”,“中国”
  • city(字符串):城市名称如“北京”,“上海”,“纽约”
  • months(数字):时间范围(月),默认:3
  • status(字符串):招募状态,默认:“RECRUITING”
  • pageSize(数字):每页结果数,默认:30,最大:100
  • pageToken(字符串):分页标记

示例:

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

2. get_trial_details

获取全面的试验详情,包括:

  • 主要研究者(PI)信息
  • 按城市划分的医院地点
  • 联系方式(电话、电子邮件)
  • 详细的试验描述
  • 入选标准(包含/排除)
  • 主要/次要终点

参数:

  • nctId(字符串,必需):NCT 编号如“NCT04852770”

示例:

{
  "nctId": "NCT04852770"
}

3. search_by_location

通过地理位置坐标搜索试验。

参数:

  • latitude(数字,必需):纬度
  • longitude(数字,必需):经度
  • radius(数字):搜索半径(英里),默认:50
  • condition(字符串):疾病/条件(可选)
  • keywords(字符串):关键词(可选)
  • status(字符串):招募状态,默认:“RECRUITING”
  • months(数字):时间范围,默认:3
  • pageSize(数字):每页结果数,默认:30

示例:

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

输出格式

所有响应均为 JSON 格式,优化用于 LLM 处理。

搜索结果

{
  "totalCount": 13,
  "count": 13,
  "studies": [
    {
      "nctId": "NCT06218914",
      "title": "I期研究调查TCRTs KRAS突变...",
      "status": "RECRUITING",
      "conditions": ["胰腺癌", "KRAS G12D"],
      "interventions": [{"type": "药物", "name": "NT-112"}],
      "sponsor": "阿斯利康",
      "studyType": "干预性",
      "phase": ["I期"],
      "lastUpdate": "2024-10-15"
    }
  ]
}

试验详情

包括所有搜索字段以及:

  • investigators[] - PI 和研究团队
  • overallOfficials[] - 研究官员
  • centralContacts[] - 全球联系信息(电话、电子邮件)
  • locations[] - 所有医院站点及当地联系人
  • locationsSummary - 统计数据(国家、城市、总站点数)
  • eligibility - 详细的入选/排除标准
  • primaryOutcomes[], secondaryOutcomes[] - 研究终点
  • briefSummary, detailedDescription - 完整的研究描述

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

贡献

欢迎贡献!请打开一个问题或提交一个拉取请求。

特别感谢 Xiaoyibao-Pancrepal & xiao-x-bao 社区 对癌症/罕见病患者及其家庭的支持与 ❤️ & AI!