Vara帮助中心
目录 — 点击展开

MCP / 接入 AI 助手

把 Vara 接进 Claude Code / Codex 等 AI 助手 — 用大白话读写实验，或让 AI 把论文变成可复现草稿。

面向开发者 / 高级用户。 本页涉及命令行配置与 API key，普通用户可以跳过——日常用网页或客户端就够了。

这是什么

Vara MCP 是一个本地 stdio server，把 Vara 的 /v1 数据接口包成 25 个 agent 工具。配好后不用开网页，直接对 AI 助手说人话，它就代你查 / 搜 / 建 / 补充实验，传附件 / 管文献 / 管物料，或把论文导成结构化实验。用的是跟 OpenAI 网关同一个 vara_sk_ key，但走数据接口（无需配 LLM 提供商）。

25 个工具

  • 只读（任何有效 key 都能用）：列实验 · 取单个实验全文（子实验 / 步骤 / 参数 / 运行记录 / 复现风险 / 附件 / 挂接文献）· 关键词搜索 · 取导入 schema · 列每日计划 · 列文献库 · 列物料
  • 写（需 read_write key）：新建 / 改实验 · 加 / 改子实验 · 记录运行 · 改运行 · 导入 · 计划 增 / 改 / 删 · 传 / 删附件 · 文献 加 / 从 PDF 加 / 删 / 挂接 / 取消挂接 · 建物料
  • 核心数据（实验 / 子实验 / 运行）仍删不了；可删的仅：附件 · 文献（软删归档）· 文献与实验的挂接。
  • 目标不明时 AI 会先列候选让你确认，不瞎猜 / 不默认新建（"加记录前先问"）。附件支持 png / jpg / gif / webp / pdf / csv / xls / xlsx，单文件 ≤50MB。

配置（2 步）

  1. 在 /settings/api 创建一个 vara_sk_ key（要用写功能就选 read_write）
  2. 注册到 Claude Code / Codex（需 Node 18+；npx 自动从 npm 拉取，无需 clone 仓库）：
claude mcp add vara \
  -e VARA_API_KEY="vara_sk_你的key" \
  -e VARA_BASE_URL="https://www.varaapp.site/api/v1" \
  -- npx -y vara-research-mcp

重启 AI 客户端后 vara_*工具才会出现。验证：对 AI 说 "列出我的 Vara 实验"。

论文 → 可复现实验（导入）

把论文 Methods / 协议 / 笔记贴给 AI，它先取 schema 再生成结构化 bundle 导入。返回一个 reviewUrl，你在网页确认后才入库 — 未确认的草稿不进你的实验列表，导错了不用慌。

  • 每个字段标来源：explicit原文逐字 · partial缺值 · inferred推断 · missing没提，都带置信度
  • 缺的不瞎编 → 进 "复现风险"；AI 补的不混入原文 → 进 "AI 推断"，附原文引用 + 核对提示
  • 步骤严格按原文顺序；来源语言不限（中文论文也能导，默认翻译成英文输出）

边界与报错

  • 403 — key 没有写权限，去 /settings/api 建 read_write key
  • 404 — id 不存在或不属于你（先 search 确认）；429 — 写超 60 次/分钟，等一下重试
  • 数据隔离：只能看 / 改这个 key 所属账号的数据；单次响应超 25000 字符会截断（换更具体的查询或用 id）