关于 rightos-mcp
rightos-mcp 让 AI Agent 管理排队、诊所候诊、电动汽车充电、活动和包裹领取的数字 QR 票券。它验证票券权益而不要求终端用户提供身份信息,并区分公共工具与组织运营工具。
主要功能
- 01签发和验证 QR 票券
- 02转让或取消票券
- 03管理地点与政策
- 04导出组织数据
- 05配置签名 Webhook
适用场景
- 01签发排队或诊所候诊票
- 02验证电动汽车充电票券
- 03设置地点的转让规则
- 04导出组织记录
MCP 相关
该 MCP 服务将 RightOS 的票券、地点、政策、数据导出和 Webhook 操作作为工具提供给 MCP 客户端。部分工具公开可用;组织运营操作需要 `RIGHTOS_API_KEY`。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@i-s3/rightos-mcp — RightOS MCP 服务
(MCP)模型上下文协议服务,适用于 RightOS — 让 AI Agent 无需编写 HTTP 代码,即可签发、验证和转让用于排队、诊所候诊、电动汽车充电、活动和包裹取件的数字二维码票券。
**面向编码 Agent:**从 npx -y @i-s3/rightos-mcp 和演示密钥 rk_demo_00000000000000000000 开始。完整文档:llms-full.txt · OpenAPI · ai.txt
RightOS 验证的是是否拥有有效权利,而不是持有者的身份。终端用户无需提供姓名、电话号码或出生日期。
RightOS 不是出租车或网约车服务。它不安排车辆、不设定车费、不分配司机,也不撮合调度。
设置
将以下内容添加到 MCP 客户端配置中(Cursor、Claude Desktop 等):
{
"mcpServers": {
"rightos": {
"command": "npx",
"args": ["-y", "@i-s3/rightos-mcp"],
"env": {
"RIGHTOS_API_KEY": "rk_live_..."
}
}
}
}
RIGHTOS_API_KEY 是可选项。不设置时,只有公共工具可用(套餐、票券查询、验证、转让、持有者取消、地点政策和政策预设)。注册组织即可获取密钥——免费套餐,无需信用卡。
如需使用共享演示组织进行试用,请将 RIGHTOS_API_KEY 设置为 rk_demo_00000000000000000000。
工具
公共工具(无需 API 密钥):
| 工具 | 描述 |
|---|---|
list_plans | 列出定价套餐(全球统一) |
get_token | 按 ID 获取 Right Token(不会返回密钥代码) |
verify_token | 使用验证码验证票券 |
transfer_token | 通过重新设定密钥转让票券(旧代码将失效) |
holder_cancel_token | 以当前持有者身份自行取消票券(视政策而定) |
get_location_policy | 获取地点的有效政策(公开,便于透明查阅) |
list_policies | 列出所有行业预设和国家叠加政策(JP/US/GB/KR/TW/FR/DE/IT/ES/AU) |
运营方工具(需要 RIGHTOS_API_KEY):
| 工具 | 描述 |
|---|---|
list_locations | 列出组织的地点 |
create_location | 创建地点(类型决定行业政策预设) |
set_location_policy | 覆盖或重置地点政策 |
get_policy_history | 政策变更审计日志(仅追加,最新记录在前) |
issue_token | 签发数字二维码票券(代码和钱包 URL 仅返回一次) |
use_token | 服务完成后将票券标记为已使用 |
cancel_token | 取消票券 |
export_data | 将组织的所有数据导出为 JSON(无供应商锁定) |
list_webhooks | 列出出站 Webhook(不包含签名密钥) |
create_webhook | 注册 Webhook——使用 HMAC-SHA256 对传送内容签名;密钥仅返回一次 |
delete_webhook | 删除 Webhook |
示例提示词
- “为我的主柜台签发一张排队票券,并提供钱包 URL。”
- “验证此票券:tok_...,验证码为 K7MP-...”
- “将我的电动汽车充电地点设为不可转让。”(根据行业预设,该地点已经不可转让——Agent 可通过
get_location_policy查询)
资源
- MCP 设置(易于阅读)
- ai.txt · llms.txt · llms-full.txt
- OpenAPI 3.1 规范
- TypeScript SDK
@i-s3/rightos· Python SDKrightos-sdk - MCP Registry(已发布):
io.github.suomimasuda/rightos-mcp
许可证
MIT © I-S3 Inc.
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。