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服務器，如需進一步幫助，請隨時聯繫技術支持團隊。