ClinicalTrials-MCP-Server

🚀 临床试验MCP服务器指南

本指南详细介绍了临床试验MCP服务器的安装、使用方法、功能模块、资源接口、配置示例等内容，帮助用户快速上手并使用该服务器进行临床试验相关信息的查询和处理。

🚀 快速开始

安装要求

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

🔧 技术细节

项目结构

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

核心功能实现

• 临床试验搜索：通过关键词或条件与ClinicalTrials.gov API交互，返回匹配试验的基本信息。
• 详细试验资料查询：根据输入的NCT编号，从ClinicalTrials.gov API获取更详细的试验信息。

数据处理功能实现

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

📄 许可证

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

⚠️ 重要提示

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

💡 使用建议

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

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

版本信息

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

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