用途
W3Ship Commerce MCP Server 是面向 AI 驱动商业的 MCP（Model Context Protocol）服务器，目标是让 AI 智能体代替用户完成购物、下单、物流跟踪、预约、代币兑换和 P2P 交易等操作。用户无需密码或登录，仅凭密码学身份即可完成上述流程。
主要能力
该服务器共提供 22 个工具，覆盖以下模块：
- 购物车（TMF663）：创建和管理购物车。
- 订单（TMF622）：下单和管理订单。
- 物流跟踪（TMF621）：追踪配送状态。
- 会话预约：预约服务会话，请求转发至 w3ship.com API。
- 身份查询：身份查询请求转发至集中式 W3Ship API（w3ship.com/api/identity），签名验证与数据库访问均在服务端完成，用户端无需 AWS 凭证。
- Uniswap Swap（v1.3.0 新增）：需要 UNISWAP_API_KEY，可在 developers.uniswap.org 免费获取。Base 链内置代币地址包括 ETH、USDC、USDT、DAI、WETH，其他代币可传入任意 ERC-20 合约地址。
- P2P 市场（v1.4.0 新增）：商品分类包括 electronics、clothing、collectibles、home、sports、gifts、books、other；任何拥有钱包地址的用户都是商户。
- 支付与履约（v1.4.0 新增）：P2P 订单自动识别上架商品（LST-* 前缀），填入卖家钱包地址，并将支付状态设为 awaiting_payment；支付完成后，卖家使用 add_tracking 提供物流信息。
- 促销商品与自提（v1.6.0 更新）：促销上架支持三种履约模式；v1.6.0 新增门店自提，AI 会返回自提地点、营业时间和说明，自提claim无需登记地址，仅需钱包身份。
使用方式
通过 npx 安装（推荐），无需安装，只需配置 AI 客户端：
- Claude Desktop：配置 claude_desktop_config.json
- Cursor：配置 .cursor/mcp.json
- VS Code：配置 .vscode/mcp.json
环境要求：需要 Redis / Valkey 实例（用于购物车、订单和物流存储）。本地可通过 docker run -p 6379:6379 redis:latest 运行，也可使用任意 Redis 兼容服务（AWS ElastiCache、Upstash 等）。
相关环境变量与密钥获取：
- MetaMask 用户：直接复制以太坊地址（如 0x1234...abcd）即可使用。
- Dah.mx 用户：Settings → AI Assistant Setup → 复制密钥。
- 演示/测试：不设置密钥，在 AI 助手中使用 generate_demo_key。
- 生产使用建议在 MCP 配置中通过 W3SHIP_PUBLIC_KEY 设置真实钱包密钥。
密码学身份：W3Ship 使用密码学身份，无用户名、无密码、无账号，支持三种身份类型；钱包地址或公钥即为购物车 ID，无需注册。
架构
MCP 服务器为轻客户端，将本地购物车/订单存储与集中式 W3Ship 服务结合：
- 商业（购物车、订单、物流）→ 存储在本地 Redis
- 身份（地址查询）→ 转发至 w3ship.com API
- 会话预约 → 转发至 w3ship.com API
用户端无需 AWS 凭证，也无需云配置。
适用场景
适用于希望让 AI 智能体代为完成购物流程、订单与物流管理、服务预约、代币兑换、P2P 买卖以及促销商品领取与门店自提的用户和开发者，尤其适合偏向使用钱包身份而非账号体系进行身份验证的场景。
限制
资料未提供除上述内容之外的功能、收费、价格、平台兼容性或效果说明，相关细节暂未提供。项目许可为 MIT，详见 LICENSE 文件。
