🚀 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

感谢这些杰出的项目为我们指引方向！ 🙌