草料二维码 · 扫码端 (CaoLiao QR Code Scan-side)

im.cli由 cli.im 发布v0.1.0更新于 Nov 20, 2026

Read the public content, history and available forms behind one CaoLiao QR code. No login.

发布方自己的服务:scan.mx Email Diagnostics

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

只读的远程 MCP,让 AI 助手读取草料二维码(cli.im)背后的公开内容、履历和可填表单。

可以做什么
  • 取回单个码的物体卡片:身份三元组、属性、关系、状态、媒体和最近记录
  • 列出该码当前可执行的操作与表单,并读取某个操作的完整字段定义
  • 按时间倒序读取该码的完整记录履历(巡检、报修、保养等),支持游标分页
  • 查询该码的换绑历史,了解它曾指向哪个物
适用场景
当用户扫到或收到一张草料二维码,希望助手说明这个物是什么、有哪些记录、当前能填哪些表单或做哪些状态变更,且不想登录时使用。
运行要求
需要可访问的远程 Streamable HTTP 端点;无需本地安装、登录、API 密钥或环境变量。客户端需支持通过 HTTP 连接远程 MCP 服务。
安装前请注意
五个工具均为只读;提交表单或变更状态不在此服务中提供,需使用另一套带 OAuth 授权的管理端服务。物 id 为过渡期码派生 id,不宜持久化依赖,稳定标识是码的 URI。字段缺失表示未跟踪或无法解析,并不等于 false 或空。

安装

在 SourceWeft 中

  1. 打开 控制台中的 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side),将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/im.cli%2Fcaoliao-scan/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "caoliao-qr-code-scan-side": {
      "type": "http",
      "url": "https://mcp.objqr.com/mcp"
    }
  }
}

README

草料二维码 MCP

English

草料二维码(cli.im)提供官方的远程 MCP 服务,让 AI 助手直接使用草料里的码、表单和记录。服务由草料托管,不需要本地安装或部署。

管理端 MCP扫码端 MCP
给谁用做码、管码的人,或替他干活的 AI扫到一张码的人,或替他干活的 AI
能做什么建码、批量建码、搭表单和巡检计划,查询记录、巡检进度和扫码统计读取一张草料码的公开内容、履历和可填表单
服务地址https://open.cli.im/mcphttps://mcp.objqr.com/mcp
传输方式Streamable HTTPStreamable HTTP
鉴权OAuth 授权组织,不需要密钥不需要登录
推荐名称caoliao-admincaoliao-scan

扫码端同侧还提供 A2A 服务:https://a2a.objqr.com。

完整文档在草料开放平台:https://cli.im/open-api/agent/overview.html

最快的方式:让 AI 自己安装

把下面这段话发给你的 AI。完整版提示词(包含配套 Skill 的安装)见快速开始。

text
请帮我接入草料二维码管理端 MCP。MCP 名称:caoliao-adminMCP 地址:https://open.cli.im/mcp传输方式:Streamable HTTP(部分客户端的 type 写作 http)鉴权方式:OAuth,不需要填写任何密钥
如果你能修改当前客户端的 MCP 配置,就按上面的名称和地址添加,保留其他已有配置;如果不能,请告诉我该怎么手动添加,不要假装已添加。OAuth 授权需要我本人在浏览器里登录草料账号并选择组织,请告诉我如何发起授权。完成后调用草料 MCP 确认当前连接的组织,只验证,不创建或修改任何数据。

管理端 MCP:各客户端的配置

WorkBuddy、千问办公:在应用市场搜索「草料二维码」安装。图文步骤见 WorkBuddy、千问办公、豆包工作。

Claude Code

bash
claude mcp add --transport http caoliao-admin https://open.cli.im/mcp

然后在 Claude Code 里输入 /mcp,选择 caoliao-admin 完成授权。

Cursor:在 ~/.cursor/mcp.json 里加入

json
{  "mcpServers": {    "caoliao-admin": {      "url": "https://open.cli.im/mcp"    }  }}

VS Code:在 .vscode/mcp.json 里加入

json
{  "servers": {    "caoliao-admin": {      "type": "http",      "url": "https://open.cli.im/mcp"    }  }}

Claude 网页版和桌面版:在「设置 → 连接器」里添加自定义连接器,地址填 https://open.cli.im/mcp。

其他客户端

json
{  "mcpServers": {    "caoliao-admin": {      "type": "streamable-http",      "url": "https://open.cli.im/mcp"    }  }}

type 的取值因客户端而异,部分客户端使用 http。

添加后按客户端提示完成 OAuth 授权:登录草料账号,选择要授权的组织。可以对 AI 说下面这句话验证:

text
请使用草料 MCP,确认我连接的组织和可用能力。只验证,不创建或修改数据。

授权机制

管理端 MCP 按 MCP 授权规范(OAuth 2.1)实现,支持自动发现的客户端只需要服务地址。

项目内容
资源元数据https://open.cli.im/.well-known/oauth-protected-resource
授权服务器元数据https://oauth.cli.im/.well-known/oauth-authorization-server
客户端注册动态注册(RFC 7591),不需要事先申请
授权方式授权码 + PKCE(只支持 S256)、刷新令牌、设备码(RFC 8628)
scopemcp:tools、records.read、templates.read、templates.write、qrcodes.write、assets.write

授权使用你在所选组织里的现有权限,不会扩大权限。撤销授权:草料管理中心「全局设置 → 安全与溯源 → 授权管理」。

详细说明见开发者接入,工具清单见工具列表。

配套 Skill

管理端有配套的 Agent Skill,指导 AI 整理资料、上传文件和批量建码:caoliao/caoliao-admin-skills。

bash
npx skills add caoliao/caoliao-admin-skills --skill caoliao-admin

扫码端 MCP

不需要登录,添加地址即可使用,共 5 个只读工具。

Claude Code

bash
claude mcp add --transport http caoliao-scan https://mcp.objqr.com/mcp

其他客户端

json
{  "mcpServers": {    "caoliao-scan": {      "type": "http",      "url": "https://mcp.objqr.com/mcp"    }  }}

用 curl 验证:

bash
curl -X POST https://mcp.objqr.com/mcp \  -H 'content-type: application/json' \  -H 'accept: application/json, text/event-stream' \  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"demo","version":"0"}}}'

文档:扫码端快速开始、工具列表、数据范围与授权、A2A 接入。

本仓库的内容

本仓库是草料 MCP 服务的说明和接入配置,服务端代码不在这里。

text
servers/├── caoliao-admin/server.json   # 管理端 MCP 的服务描述└── caoliao-scan/server.json    # 扫码端 MCP 的服务描述

server.json 采用 MCP Registry 的格式,尚未发布到官方 Registry。

相关链接

来源:README.md,提交 7a9ed9b

工具

5

entity_get

根据草料码取回该物的 ObjectCard v2:身份三元组(thing 物/code 码/binding 绑定)、属性、关系槽、状态(states=业务状态,code.status=码状态)、账本(records:总数+最近条目)、媒体、操作契约(actions 带注解与 humanUrl)。扫码或拿到码链接后的第一步。注意:thing.id 为过渡期码派生 id(idScheme=code-derived),勿持久化依赖;应持久化的稳定标识是 code.uri。缺席字段=未跟踪/不可解析,绝非 false 或空。带 formats 可附 markdown 等其它表示。

输入参数code必填formats

entity_actions_list

列出某草料码实体此刻可执行的操作清单(可填哪些表单、有哪些状态变更),仅列出、不执行。想知道'这个码能做什么'时用;拿到某个操作的完整填写字段用 entity_action_get,真正提交是写入工具(需授权)。

输入参数code必填

entity_action_get

取某个操作的完整可填字段 schema(字段名、类型、是否必填、可选项)。entity_actions_list 只列操作、不带字段;准备填某个表单前用这个拿到它的完整字段定义。读 schema 无需授权,提交才需要。

输入参数code必填actiontpl_id

entity_records_list

取某草料码所指物的完整账本(记录履历:巡检、报修、保养等),按时间倒序,游标分页。entity_get 的 records.preview 只给最近几条;要看完整历史用这个,返回的 nextPageToken 传回 page_token 取下一页。每条记录带 snapshot(当时的码+物),时间为 ISO 8601 带时区。

输入参数code必填sizepage_token

entity_bindings_list

查某草料码的换绑历史:这个码何时指向过哪个物(审计场景)。当前世代码与物 1:1(historyCount=1),恒返回单条 current 绑定;换绑功能上线后返回完整绑定事件序列。thingId 为过渡期码派生 id,勿持久化依赖。

输入参数code必填

版本历史

1
  1. v0.1.0最新Nov 20, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Scan 集成