使用说明

项目简介

AACT Clinical Trials MCP服务器是一个实现了Model Context Protocol (MCP) 的后端应用，旨在方便用户通过LLM客户端访问和分析Aggregate Analysis of ClinicalTrials.gov (AACT) 数据库中的临床试验数据。该服务器提供了一系列资源、Prompt模板和工具，帮助用户深入了解特定疾病领域的临床试验格局，并从中提取有价值的分析洞见。

主要功能点

资源 (Resources):
- 'memo://insights': 存储和管理临床试验分析的发现和见解，形成分析备忘录。
- 'schema://database': 提供AACT数据库的结构信息（Schema），帮助用户理解数据表和字段。
Prompt 模板 (Prompts):
- 'indication-landscape': 分析特定治疗领域（如多发性硬化症、乳腺癌）的临床试验模式、发展趋势和竞争态势，支持用户自定义分析主题。
工具 (Tools):
- 'read-query': 允许用户执行SELECT SQL查询，直接从AACT数据库中提取数据。
- 'list-tables': 列出AACT数据库中所有可用的数据表，帮助用户快速了解数据库包含的数据内容。
- 'describe-table': 查看指定数据表的详细Schema信息，包括列名、数据类型等，辅助用户构建精确的查询。
- 'append-insight': 支持用户记录分析过程中的关键发现和见解，并将其添加到分析备忘录中。

安装步骤

注册 AACT 数据库账号: 访问 https://aact.ctti-clinicaltrials.org/users/sign_up 注册一个免费账户，获取数据库访问权限。
设置环境变量: 配置以下环境变量，用于服务器连接 AACT 数据库：
- 'DB_USER': 您的 AACT 数据库用户名
- 'DB_PASSWORD': 您的 AACT 数据库密码

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以下是两种配置示例，您可以根据实际情况选择其一添加到客户端的配置文件（例如 'claude_desktop_config.json'）：

选项 1: 使用已发布的包 (如果项目已发布为Python包)

"mcpServers": {
    "CTGOV-MCP": {  //  服务器名称，可以自定义
      "command": "uvx",  //  运行命令，这里假设使用 uvx 运行已安装的包
      "args": [
        "mcp-server-aact"  //  包的入口点命令
      ],
      "env": {  //  环境变量配置
        "DB_USER": "YOUR_USERNAME",  //  替换为您的 AACT 数据库用户名
        "DB_PASSWORD": "YOUR_PASSWORD"   //  替换为您的 AACT 数据库密码
      }
    }
}

选项 2: 从源代码运行 (开发模式)

"mcpServers": {
    "CTGOV-MCP-DEV": {  // 服务器名称，可以自定义，用于区分开发版本
      "command": "uv",  // 运行命令，这里假设使用 uv 运行 Python 代码
      "args": [
        "--directory",  //  指定工作目录
        "PATH_TO_REPOSITORY",  //  替换为您的仓库本地路径
        "run",  //  uv 的 run 命令
        "mcp-server-aact"  //  Python 包的入口点命令
      ],
      "env": {  // 环境变量配置
        "DB_USER": "YOUR_USERNAME",  //  替换为您的 AACT 数据库用户名
        "DB_PASSWORD": "YOUR_PASSWORD"   //  替换为您的 AACT 数据库密码
      }
    }
}

注意:

请将 'YOUR_USERNAME' 和 'YOUR_PASSWORD' 替换为您在 AACT 数据库注册的用户名和密码。
如果选择选项 2，请将 'PATH_TO_REPOSITORY' 替换为此仓库在您本地机器上的实际路径。
配置文件 'claude_desktop_config.json' 的位置通常在用户目录下的特定应用数据文件夹中，例如 macOS 系统在 '/Users/YOUR_USERNAME/Library/Application Support/Claude/'，如果文件不存在则需要手动创建。

基本使用方法

启动 MCP 客户端 (如 Claude Desktop)。
客户端成功加载并连接到配置的 AACT Clinical Trials MCP 服务器。
在客户端中，您可以：
- 列出可用的 资源 (Resources)，例如查看分析备忘录或数据库Schema。
- 调用 工具 (Tools)，例如执行 SQL 查询以检索临床试验数据，或记录分析见解。
- 使用 Prompt 模板 (Prompts)，例如使用 'indication-landscape' Prompt 分析特定疾病领域的临床试验情况。
通过自然语言指令，结合可用的资源、工具和Prompt，与LLM客户端交互，完成临床试验数据的分析任务。

关键词