CDISC Library MCP Server

MCP Server for CDISC Library API - 提供对临床数据标准的完整访问。

功能特性

• 🔧 21 个 MCP Tools - 覆盖 SDTM, ADaM, CDASH, CT 等标准
• 📦 MCP Resources - 产品列表、API 信息
• 💬 MCP Prompts - 引导式标准探索
• 🗄️ 持久化缓存 - 减少 API 调用，加速访问
• 🇨🇳 中文错误提示 - 友好的错误消息

安装

方式一：uvx（推荐，自动安装）

无需手动安装，MCP 客户端会自动下载（依赖里已声明 mcp>=1.6.0,<2.0.0，uvx 会自动遵守该上界，不需要再手工加 --with "mcp<2.0.0"）：

{
  "mcpServers": {
    "cdisc-library": {
      "command": "uvx",
      "args": ["cdisc-library-mcp"],
      "env": {}
    }
  }
}

凭据推荐放在 ~/.cdisc-mcp/.env（不要写进客户端配置）：

CDISC_API_KEY=your-api-key-here

如果必须内联，也可以把 "env": {} 换成 {"CDISC_API_KEY": "your-api-key-here"}。

方式二：pip 安装

pip install cdisc-library-mcp

然后在 MCP 客户端配置：

{
  "mcpServers": {
    "cdisc-library": {
      "command": "cdisc-library-mcp",
      "env": {
        "CDISC_API_KEY": "your-api-key-here"
      }
    }
  }
}

获取 API Key

1. 访问 CDISC Library API Portal
2. 登录或注册 CDISC 账号
3. 在 Profile 页面 获取 API Key

MCP 客户端配置文件位置

可用工具

全局约定（0.1.6+）

• 响应默认瘦身：剥除 _links/links/@search.* 噪声，链接折叠为 refs（标签→href）；

每个工具都有 raw（boolean，默认 false），传 true 拿未瘦身原始载荷。

• `standard` 为 enum：sdtm, sdtmig, sendig, adam, adamig, cdash, cdashig。
• `version` 支持 `'latest'`：自动解析为该产品当前最新版本。
• 所有工具均为只读 GET，带 readOnlyHint=true 注解。

标准查询

数据集操作

ADaM 数据结构（0.1.9+）

ADaM / ADaMIG 的元数据挂在 /datastructures 下，没有 datasets 端点； 变量集名与变量名（如 SITEGRy）跨版本不稳定且区分大小写，工具会自动解析。

控制术语

CT 提交值（submissionValue）的取法：Library API 的 codelist terms 端点是唯一的 批量术语清单来源，但不返回逐术语提交值，raw=true 也不会多给一个字段；它顶部的 submissionValue（如 LBTESTCD）是 codelist 自己的变量名。提交值只存在于包级载荷 （整包内联）与单术语详情里。get_codelist_submission_values 读前者，因此拿一张表的全部 提交值是 1~2 次请求，而不是逐条 N 次（LBTESTCD 2397 术语：冷启动 26.1s / 命中缓存 1.6s， 对比逐条 260 次 ≈ 150s）。只要术语名与 C 代码时用 get_codelist_terms 更省。

搜索与比较

版本号格式

CDISC Library API 使用 - 分隔版本号：

工具会自动转换格式，支持两种输入；也可传 latest 自动解析为最新版本。

注意 standard 与 version 必须匹配（如 sdtmig 用 3-x，sdtm 用 1-x/2-x），拿不准时传 latest。

环境变量

.env 查找顺序

按以下顺序取*第一个自身声明了 `CDISC_ 变量**的文件；只声明了别的项目变量的 .env` 会被跳过（不会导入其键值）：

1. 当前工作目录 ./.env —— stdio 启动时这是 MCP 客户端的项目目录，通常与本服务无关
2. 项目根目录 .env（源码安装 / pip install -e 场景）
3. ~/.cdisc-mcp/.env（推荐落点，与 uvx / pip 安装方式无关）

三个都没命中时，退回真实环境变量（例如客户端注入的 env）；都没有则启动时打印未认证警告。

开发

# 克隆仓库
git clone https://github.com/whereayan/cdisc-library-mcp.git
cd cdisc-library-mcp

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
python -m pytest tests/ -v

# 运行测试覆盖率
python -m pytest tests/ --cov=src/cdisc_mcp

发布

# 使用发布脚本
python scripts/release.py 0.1.3

# 或手动发布
python -m build
twine upload dist/*

许可证

MIT License