Clinicaltrials MCP Server

🚀 临床试验MCP服务器指南

本指南旨在帮助你了解和使用临床试验MCP服务器，它能让你方便地搜索和查询ClinicalTrials.gov数据库中的临床试验信息，同时具备数据处理等实用功能。

🚀 快速开始

安装要求

• Python版本：需使用3.10及以上版本。
• 依赖库：执行以下命令安装所需依赖库：

  pip install FastMCP pytrials pandas
  

项目结构

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

✨ 主要特性

核心功能

• 临床试验搜索：支持通过关键词或条件搜索ClinicalTrials.gov数据库，返回匹配试验的基本信息，如试验标题、NCT编号、研究疾病和简要摘要。
• 详细试验资料查询：输入NCT编号可获取更详细的试验信息，包括全部标题、研究疾病、试验阶段、干预措施和结果分析。

数据处理功能

• CSV数据导入：支持加载本地CSV文件，并查看文件内容。
• CSV文件列表：列出当前目录下所有已保存的CSV文件。

📦 安装指南

安装要求

• Python版本：3.10+
• 依赖库：运行pip install FastMCP pytrials pandas进行安装。

💻 使用示例

基础用法

搜索临床试验

询问Claude：

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

将返回以下信息：

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

获取详细资料

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

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

将返回：

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

📚 详细文档

MCP资源接口

资源路径说明

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

配置示例

Claude Desktop配置（Mac OS）

在claude_desktop_config.json中添加：

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

Windows配置示例

在claude_desktop_config.json中添加：

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

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": []
    }
  }
}

🔧 技术细节

本项目使用FastMCP框架实现主要的MCP服务器，通过clinical_trials.py文件中的辅助函数与ClinicalTrials.gov API进行交互，实现临床试验的搜索和详细信息查询等功能。

📄 许可证

文档中未提及许可证相关信息。

⚠️ 重要提示

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

💡 使用建议

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

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

版本信息

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

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