AACT Clinical Trials

🚀 AACT 臨床試驗 MCP 服務器

這是一個藉助 FastMCP 框架實現的模型上下文協議 (Model Context Protocol) 服務器，其核心價值在於提供對 AACT（ClinicalTrials.gov 的綜合分析）數據庫的便捷訪問。通過該服務器，AI 助手能夠直接從 ClinicalTrials.gov 數據庫查詢臨床試驗數據，極大地提升了數據獲取的效率。

🚀 快速開始

此服務器允許 AI 助手直接從 ClinicalTrials.gov 數據庫查詢臨床試驗數據。你可以按照以下步驟開始使用：

1. 配置必要的環境變量 DB_USER 和 DB_PASSWORD，分別對應你的 AACT 數據庫用戶名和密碼。
2. 參考“與 Semantic Kernel 的使用”部分的代碼示例，將該服務器集成到你的項目中。

✨ 主要特性

工具

• list_tables
  • 功能：獲取 AACT 數據庫中所有可用表的概述，幫助你在進行分析之前全面瞭解數據庫結構。
• describe_table
  • 功能：查看特定 AACT 表的詳細結構，會顯示列名稱和數據類型。
  • 示例：{"table_name": "studies"}
• read_query
  • 功能：在 AACT 臨床試驗數據庫上執行 SELECT 查詢，並且會安全處理 SQL 查詢並進行驗證。
  • 示例：{"query": "SELECT nct_id, brief_title FROM ctgov.studies LIMIT 5"}
• append_insight
  • 功能：記錄分析過程中發現的關鍵見解，有助於構建分析敘述。
  • 示例：{"finding": "過去五年來，3 期腫瘤學試驗的數量增加了 15%"}

資源

• schema://database：返回數據庫架構的 JSON 資源。
• memo://insights：返回會話期間收集的見解備忘錄。

📦 安裝指南

必要環境變量

• DB_USER：你的 AACT 數據庫用戶名。
• DB_PASSWORD：你的 AACT 數據庫密碼。

請確保在運行服務器之前設置好這些環境變量，以保證服務器能夠正常連接到 AACT 數據庫。

💻 使用示例

基礎用法

from semantic_kernel import Kernel
from semantic_kernel.connectors.mcp import MCPStdioPlugin

# 創建一個 AACT 臨床試驗 MCP 插件
aact_mcp = MCPStdioPlugin(
    name="aact",
    description="臨床試驗數據庫插件",
    command="uvx",
    args=["mcp-server-aact"],
    env={
        "DB_USER": "your_aact_username", 
        "DB_PASSWORD": "your_aact_password"
    }
)

# 添加到 Semantic Kernel
kernel = Kernel()
kernel.add_plugin(aact_mcp)

高級用法

以下是與該插件一起使用的示例提示，你可以根據實際需求修改這些提示來進行不同的查詢：

1. “乳腺癌臨床試驗中最常見的干預措施類型是什麼？”
2. “2023 年有多少項 3 期臨床試驗完成？”
3. “顯示不同國家糖尿病試驗的入組統計數據”
4. “過去五年來，多少百分比的腫瘤學試驗報告了結果？”

🔧 技術細節

此服務器使用以下技術構建：

• FastMCP：用於 Model Context Protocol 的實現，確保服務器能夠高效地處理模型上下文協議相關的操作。
• Python psycopg2：用於 PostgreSQL 數據庫連接，實現服務器與 AACT 數據庫之間的穩定通信。
• AACT 數據庫：作為 ClinicalTrials.gov 信息的數據源，為服務器提供了豐富的臨床試驗數據。

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

我們熱烈歡迎大家為項目做出貢獻！如果你有想法或發現問題，請按照以下步驟進行：

• 在 GitHub 上打開一個問題。
• 開始相關討論。
• 若有需要，可通過郵件聯繫：jonas.walheim@navis-bio.com。

🙏 致謝

這個項目受到以下項目的啟發並最初基於它們的代碼：

• SQLite MCP 服務器
• DuckDB MCP 服務器
• OpenDataMCP

感謝這些傑出的項目為我們指引方向！ 🙌