Aact Clinical Trials MCP Server

🚀 AACT 臨床試驗 MCP 服務器

本項目是一個基於 FastMCP 框架的 Model Context Protocol (MCP) 服務器實現，可提供對 AACT（ClinicalTrials.gov 的綜合分析）數據庫的訪問。藉助該服務器，AI 助手能夠直接從 ClinicalTrials.gov 數據庫查詢臨床試驗數據。

✨ 主要特性

工具

• 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 數據庫密碼

💻 使用示例

基礎用法

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"
    }
)

# 添加到語義內核
kernel = Kernel()
kernel.add_plugin(aact_mcp)

示例提示

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

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

🔧 技術細節

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

• FastMCP 實現 Model Context Protocol
• Python psycopg2 用於 PostgreSQL 數據庫連接
• AACT 數據庫作為 ClinicalTrials.gov 信息的數據源

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

我們歡迎大家貢獻代碼！請按以下步驟進行：

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

🙏 致謝

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

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

感謝這些傑出的項目為我們指引道路！