MCP
通过 Streamable HTTP 把 MCP 客户端连接到 CiteArk 的在线科研工具。
CiteArk 已在以下地址提供在线 MCP 服务:
https://citeark.com/mcp它同时支持现代 MCP Streamable HTTP 与旧版无状态握手。公开读取工具无需鉴权;私有读取和 request_reproduction 可通过 x-api-key 或 Authorization: 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_research、get_repository、get_claims、get_runs、get_verified_runs、get_execution_trace 与 get_evidence。其中 get_runs 是规范入口,可避免把执行成功误当成科学结论得到支持。
WebMCP 与 /mcp 的常驻服务不是同一种接入:它只在 CiteArk 标签页打开期间存在。当前浏览器工具均为只读,并且刻意使用匿名公开 API 请求,因此不会暴露私有仓库,也不能发起复现。Chrome 目前仍要求加入 WebMCP Origin Trial,或在本地启用 #enable-webmcp-testing 实验开关。