AACT Clinical Trials

🚀 AACT 臨床試驗 MCP 服務器

這是一個基於 FastMCP 框架的模型上下文協議（MCP）服務器實現，可提供對 AACT（ClinicalTrials.gov 的綜合分析數據庫）的訪問。藉助該服務器，AI 助手能夠直接從 ClinicalTrials.gov 數據庫查詢臨床試驗數據。

🚀 快速開始

若要使用此服務器，你需要配置必要的環境變量，具體如下：

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

以下是與 Semantic Kernel 結合使用的示例代碼：

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": "你的_aact_用戶名", 
        "DB_PASSWORD": "你的_aact_密碼"
    }
)

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

✨ 主要特性

工具

• list_tables
  • 獲取所有可用表的概述，可用於在進行分析前瞭解數據庫結構。
• 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：返回會話中收集見解的格式化備忘錄。

💻 使用示例

基礎用法

以下是一些與該插件一起使用的示例提示：

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

🔧 技術細節

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

• FastMCP 進行模型上下文協議實現。
• Python psycopg2 用於 PostgreSQL 數據庫連接。
• AACT 數據庫作為 ClinicalTrials.gov 信息的數據源。

📄 許可證

本項目採用 MIT 許可證。

貢獻

我們歡迎大家貢獻代碼！若你有相關想法，請：

• 在 GitHub 上打開問題。
• 開始討論。
• 郵件聯繫：jonas.walheim@navis-bio.com

致謝

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

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

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