🚀 AACT 临床试验 MCP 服务器
这是一个借助 FastMCP 框架实现的模型上下文协议 (Model Context Protocol) 服务器，其核心价值在于提供对 AACT（ClinicalTrials.gov 的综合分析）数据库的便捷访问。通过该服务器，AI 助手能够直接从 ClinicalTrials.gov 数据库查询临床试验数据，极大地提升了数据获取的效率。
🚀 快速开始
此服务器允许 AI 助手直接从 ClinicalTrials.gov 数据库查询临床试验数据。你可以按照以下步骤开始使用：
- 配置必要的环境变量
DB_USER和DB_PASSWORD，分别对应你的 AACT 数据库用户名和密码。 - 参考“与 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)
高级用法
以下是与该插件一起使用的示例提示，你可以根据实际需求修改这些提示来进行不同的查询：
- “乳腺癌临床试验中最常见的干预措施类型是什么？”
- “2023 年有多少项 3 期临床试验完成？”
- “显示不同国家糖尿病试验的入组统计数据”
- “过去五年来，多少百分比的肿瘤学试验报告了结果？”
🔧 技术细节
此服务器使用以下技术构建：
- FastMCP：用于 Model Context Protocol 的实现，确保服务器能够高效地处理模型上下文协议相关的操作。
- Python psycopg2：用于 PostgreSQL 数据库连接，实现服务器与 AACT 数据库之间的稳定通信。
- AACT 数据库：作为 ClinicalTrials.gov 信息的数据源，为服务器提供了丰富的临床试验数据。
📄 许可证
本项目采用 MIT 许可证。
🤝 贡献
我们热烈欢迎大家为项目做出贡献！如果你有想法或发现问题，请按照以下步骤进行：
- 在 GitHub 上打开一个问题。
- 开始相关讨论。
- 若有需要，可通过邮件联系：jonas.walheim@navis-bio.com。
🙏 致谢
这个项目受到以下项目的启发并最初基于它们的代码：
感谢这些杰出的项目为我们指引方向！ 🙌