临床试验MCP服务器指南

安装与使用说明

1. 安装要求

• Python版本：3.10+
• 依赖库：
  • pip install FastMCP pytrials pandas

2. 项目结构

• clinical_trials_server.py：主要的MCP服务器实现，使用FastMCP框架。
• clinical_trials.py：包含与ClinicalTrials.gov API交互的辅助函数。

3. 功能模块

3.1 核心功能

• 临床试验搜索
  支持通过关键词或条件搜索 ClinicalTrials.gov 数据库，返回匹配试验的基本信息：

  • 试验标题
  • NCT编号
  • 研究疾病
  • 简要摘要

• 详细试验资料查询
  输入NCT编号可获取更详细的试验信息：

  • 全部标题
  • 研究疾病
  • 试验阶段
  • 干预措施
  • 结果分析
  

3.2 数据处理功能

• CSV数据导入
  支持加载本地CSV文件，查看文件内容。

• CSV文件列表
  列出当前目录下所有已保存的CSV文件。

4. MCP资源接口

4.1 资源路径说明

• clinicaltrials://corona_fields：获取新型冠状病毒相关字段数据。
• clinicaltrials://full_studies：获取完整的临床试验研究数据。
• clinicaltrials://csv/{filename}：通过指定文件名加载CSV数据。
• clinicaltrials://available_files：列出所有可用的CSV文件。
• clinicaltrials://study/{nct_id}：通过NCT编号查询特定研究。
• clinicaltrials://condition/{condition}：根据疾病名称筛选相关研究。

5. 配置示例

5.1 Claude Desktop配置（Mac OS）

在claude_desktop_config.json中添加：

{
  "mcpServers": {
    "ClinicalTrials": {
      "command": "python",
      "args": ["-m", "ClinicalTrials-mcp-server"]
    }
  }
}

5.2 Windows配置示例

在claude_desktop_config.json中添加：

{
  "mcpServers": {
    "ClinicalTrials": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "ClinicalTrials-mcp-server"
      ]
    }
  }
}

5.3 Cline配置示例

在config.json中添加：

{
  "mcpServers": {
    "ClinicalTrials": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/ClinicalTrials-MCP-Server/.venv/bin/activate && python /home/YOUR/PATH/ClinicalTrials-MCP-Server/clinical_trials_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

6. 使用示例

6.1 搜索临床试验

询问Claude：

你能帮我查找关于糖尿病的最新临床试验吗？

将返回以下信息：

• 标题：完整的试验名称
• NCT编号：唯一标识符
• 研究疾病：试验针对的具体病症
• 摘要：简要的研究概述

6.2 获取详细资料

输入具体的NCT编号，例如：

告诉我关于NCT04567890的更多信息。

将返回：

• 全部标题：新型糖尿病治疗药物疗效评估研究
• 研究疾病：2型糖尿病
• 试验阶段：III期临床试验
• 干预措施：新型口服降糖药与安慰剂对照
• 结果分析：已完成，结果显示有效性显著优于对照组。

7. 注意事项

• 数据来源：所有信息均来源于ClinicalTrials.gov公开数据库。
• 更新频率：建议定期刷新以获取最新研究进展。
• 隐私保护：确保遵守相关法律法规和用户隐私政策。

8. 附加说明

8.1 技术支持

如遇问题，请访问项目主页或联系维护人员：

GitHub链接：https://github.com/clinical-trials-mcp-server
联系邮箱：support@clinicaltrials.com

8.2 版本信息

• 当前版本：v1.0.0
• 更新日志：
  • 新增功能：支持CSV文件导入与管理。
  • 优化性能：提升搜索速度和结果准确性。

感谢使用临床试验MCP服务器，如需进一步帮助，请随时联系技术支持团队。