前往 REZICS

开发者

你的 AI 代理从 /mcp 接入。

REZICS 在 /mcp 提供远程 MCP 服务器。代理使用你授权的令牌连接，可用工具会按当前权限列出，每个工具都对应一项 HTTP 操作。

转接

MCP 只负责转接，不会另开一条写入通道。

每次工具调用只会转发一次到对应的 HTTP 操作，并携带同一个令牌和幂等键。操作会决定由谁执行、能做什么，以及使用多少请求额度。

工具读取到的作品正文和网页文字一律视为数据，不会当成指令。

一张深蓝灰色的纸上打了一排圆孔，一条浅蓝色纸带在孔间上下穿过。

连接

连接分四步

  • 读取资源元数据

    GET /.well-known/oauth-protected-resource/mcp

    没有令牌的请求会收到 401 响应，响应头会指向这份元数据，其中注明授权服务器和支持的权限范围。

  • 注册并获取令牌

    RFC 7591 · PKCE

    代理客户端可以自行注册，再通过授权码和 PKCE 获取令牌。注册本身不会获得任何资源权限。

  • 列出工具

    tools/list

    列表只会列出这个身份当前可用的工具。

  • 调用工具

    tools/call

    结果会原样返回 HTTP 状态码、响应头和内容，状态码达到 400 或更高时会标记为错误。

同一项操作

代理的调用会转发到同一项 HTTP 操作。

  • 程序

    GET /v1/search/catalogue
  ?q=旅行&limit=5

  • 代理

    {
  "name": "search_catalogue",
  "arguments": {
    "query": {
      "q": "旅行",
      "limit": 5
    }
  }
}
    通过 tools/call 发送这组参数。

同一份响应

operationId
  getV1SearchCatalogue
profile
  public-catalogue-ranked-v1

按“旅行”搜索目录（示意）。代理得到同一份响应，外层多包了一层 HTTP 状态码和响应头；参数按 HTTP 操作分为 path、query、headers 和 body。

工具

工具列表

工具根据 API 的能力声明生成。声明注明工具名称、用途和所需权限范围；如果名称重复或对应的操作不存在，生成就会失败。

读取目录

  • search_catalogue

    按关键词搜索目录

    GET /v1/search/catalogue · work:read

  • read_resource

    读取一个资源

    GET /v1/resources/{resource} · work:read context:read

  • resource_summaries

    一次读取多个资源摘要

    POST /v1/resources/summaries · work:read context:read

  • resource_relations

    读取资源的关联

    GET /v1/resources/{resource}/relations · work:read

  • work_editions

    读取作品的各个版本

    GET /v1/works/{id}/releases · work:read

书架

  • library_export

    导出整个书架

    GET /v1/me/library-export · work:read rating:read

  • library_import_create

    上传书架文件

    POST /v1/me/library-imports · work:read library:write

  • library_import_rows

    逐行查看匹配结果

    GET /v1/me/library-imports/{id}/rows · work:read

  • library_import_resolve

    为一行选择作品

    PUT /v1/me/library-imports/{id}/rows/{row} · work:read library:write

  • library_import_adopt

    采用目录之外的候选作品

    POST /v1/me/library-imports/{id}/rows/{row}/adoptions · work:read library:write work:create

  • library_import_apply

    应用已审核的导入

    POST /v1/me/library-imports/{id}/apply · work:read library:write collection:edit rating:read rating:submit

  • library_import_status

    查看导入进度

    GET /v1/me/library-imports/{id}/apply · work:read

  • library_import_delete

    删除上传的文件

    DELETE /v1/me/library-imports/{id} · work:read library:write

Wiki

  • wiki_candidates

    匹配抽取出的名称

    POST /v1/wiki/candidates · wiki:propose

  • wiki_validate

    预检一份抽取结果

    POST /v1/wiki/validations · wiki:propose

  • wiki_history

    读取已接受的 Wiki 内容

    GET /v1/wiki/{work}/history · work:read

  • wiki_evidence

    读取主张的来源和引文

    GET /v1/wiki/evidence/{id} · work:read

限制

每次调用的限制

  • 30 秒

    每次工具调用的时限。

  • 1 MiB

    一般工具请求的大小上限，上传书架文件另行计算。

  • 无状态

    每个请求都会单独验证令牌，服务器不保留会话。

开发者

其他页面

用同一套 API，打造自己的工具。

让自己的程序读写作品、书架和社区数据。每次操作都遵循 REZICS 的身份与授权规则。

前往 REZICS

产品

模块

语言