Webaz MCP Server

WebAZ

让 AI Agent 成为去中心化商业协议的原生参与者。卖家零额外工作量接入新渠道，买家通过 Agent 自动购物，人类与 AI 在同一协议上平等参与。

---

核心特性

• Agent 原生：通过 MCP 协议让 Claude 直接搜索商品、下单、确认收货
• 人类 + Agent 双轨：PWA 供人类操作，MCP 供 Agent 调用，共用同一后端
• 自动执法：每笔交易有明确责任方，超时未履行自动判责，无需人工干预
• 争议系统：买卖双方举证，仲裁员裁定，败诉方缴纳 1% 仲裁费
• 声誉体系：5 级制（新手→传奇），影响质押折扣和搜索排名
• Skill 市场：卖家发布 auto_accept / catalog_sync 等能力插件，Agent 订阅后自动享用
• 货币单位：WAZ（Phase 0 为模拟代币，Phase 2 接入链上稳定币）

---

快速开始

方式一：Claude MCP 接入（Agent 原生体验）

1. 添加到 Claude Desktop 配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "webaz": {
      "command": "npx",
      "args": ["-y", "@seasonkoh/webaz"]
    }
  }
}

重启 Claude Desktop。无需手动安装，npx 会自动下载运行。

3. 开始使用

在 Claude 对话里说：

"帮我在 WebAZ 注册一个买家账号，然后搜索一下有什么商品"

Claude 会自动调用 webaz_register 和 webaz_search 完成操作。

---

方式二：PWA 浏览器界面

cd webaz
npm run pwa
# 打开 http://localhost:3000
# 手机访问：http://<本机IP>:3000

注册账号后即可使用完整功能。

---

MCP 工具清单

完整协议规范（状态机/经济模型/争议规则）可通过 MCP Resource 读取：

webaz://protocol/manifest

---

角色说明

---

交易流程

买家下单（paid）
  → 卖家接单（accepted）      ← 超时 24h：fault_seller
  → 卖家发货（shipped）       ← 超时 72h：fault_seller（需选择物流公司）
  → 物流揽收（picked_up）     ← 超时 48h：fault_logistics（回传快递单号）
  → 运输中（in_transit）
  → 投递完成（delivered）     ← 超时 48h：fault_logistics
  → 买家确认（confirmed）     ← 超时 72h：自动确认
  → 完成结算（completed）

买家在 delivered 阶段可发起争议：
  → 被告 48h 内举证 → 仲裁员 120h 内裁定
  → 超时不回应：自动判发起方胜诉
  → 败诉方缴纳订单金额 1% 仲裁费（最低 1 WAZ）
  → 裁定结果：全额退款 / 释放给卖家 / 部分退款 / 责任分配

---

资金分配

每笔成交按以下比例自动分配：

卖家上架需质押 15% 作为保证金（声誉越高折扣越大，最低 5%）。

---

开发命令

npm run pwa          # 启动 WebAZ 服务（含自动执法，端口 3000）
npm run mcp          # 单独启动 MCP Server（供 Claude Desktop 调用）
npm run demo         # 跑完整交易演示脚本
npm run test-dispute # 测试争议系统（三场景）
npm run test-skill   # 测试 Skill 市场
npm run test-rep     # 测试声誉系统
npm run test-manifest# 测试协议 Manifest

---

技术栈

---

当前阶段

Phase 0 · 概念验证 ✅ 完成 Phase 1 · 功能完善 ✅ 完成

Phase 2 将把核心资金和状态上链，实现真正的去中心化。

---

路线图

• 状态机 + 责任归因引擎
• MCP Server（11 个工具）
• 通知系统（SSE 实时推送）
• 争议系统（举证 + 超时自动裁定 + 仲裁费）
• 声誉积分体系
• Skill 市场
• Protocol Manifest（机器可读协议规范）
• PWA 前端（全角色覆盖，人类 + Agent 双轨）
• 链上集成（Base/Optimism）
• IPFS 证据存储
• 治理 DAO