MCP

通过 Streamable HTTP 把 MCP 客户端连接到 CiteArk 的在线科研工具。

CiteArk 已在以下地址提供在线 MCP 服务:

https://citeark.com/mcp

它同时支持现代 MCP Streamable HTTP 与旧版无状态握手。公开读取工具无需鉴权;私有读取和 request_reproduction 可通过 x-api-keyAuthorization: Bearer 携带 CiteArk API Key,发起复现需要 run 权限。

工具

工具用途
search_research搜索紧凑公开研究记录,支持游标分页
get_repository读取一个仓库,并仅加入所需部分
get_claims读取结论、研究计划、证据状态与规范计量,可选不可变 Assessment
get_runs分别按物理执行状态和 Assessment 结论筛选运行
get_verified_runs旧版 state=verified 兼容视图;新调用应使用 get_runs
get_execution_trace读取运行,可选日志、环境、证据、Assessment 与执行证明
get_evidence解析证据元数据与下载地址
verify_attestation对运行的签名陈述进行密码学验证
request_reproduction将可执行结论加入复现队列

资源

  • citeark://agent-api/schema — 规范 JSON Schema 与计量语义
  • citeark://agent-api/openapi — REST 接口的 OpenAPI 3.1 描述

客户端配置

使用客户端标准的远程 MCP 服务配置,并把地址指向 https://citeark.com/mcp。需要写权限时,配置请求头,不要把密钥写入提示词或源代码:

{
  "url": "https://citeark.com/mcp",
  "headers": {
    "x-api-key": "${CITEARK_API_KEY}"
  }
}

请把密钥保存在客户端的 Secret 或环境变量存储中。只使用公开搜索的客户端应省略请求头。

若客户端提供专门的 Bearer Token 字段,也可以发送 Authorization: Bearer ${CITEARK_API_KEY}

不支持 MCP 的客户端可以通过 Agent API 获得相同的数据与操作能力。

WebMCP

CiteArk 也通过 Chrome 的实验性 WebMCP API 注册了一组浏览器标签页工具。兼容的浏览器 Agent 打开 CiteArk 后,可以直接从页面发现 search_researchget_repositoryget_claimsget_runsget_verified_runsget_execution_traceget_evidence。其中 get_runs 是规范入口,可避免把执行成功误当成科学结论得到支持。

WebMCP 与 /mcp 的常驻服务不是同一种接入:它只在 CiteArk 标签页打开期间存在。当前浏览器工具均为只读,并且刻意使用匿名公开 API 请求,因此不会暴露私有仓库,也不能发起复现。Chrome 目前仍要求加入 WebMCP Origin Trial,或在本地启用 #enable-webmcp-testing 实验开关。