Unicity MCP Merch

Sphere MCP Merch服务器

Unicity商品店的MCP（模型上下文协议）服务器。提供LLM访问权限，通过Nostr使用UCT代币浏览和购买Unicity品牌商品。

特性

• 产品目录：印有图案的T恤、连帽衫、杯子、帽子
• 订单管理：创建订单，跟踪状态
• Nostr集成：通过Nostr协议发送的付款请求
• Unicity区块链：使用名称标签进行身份和支付路由
• 自动标识：服务器在首次运行时创建自己的区块链身份
• HTTP传输：支持传统SSE和现代可流式HTTP

可用产品

MCP工具

HTTP端点

服务器在HTTP（默认端口3001）上运行，具有两种传输协议：

传统SSE（MCP检查员，老客户）

流式HTTP（现代客户端）

健康检查

快速开始

1.配置环境

cp .env.example .env

编辑 .env 具有所需值：

MCP_NAMETAG=merch-mcp
PAYMENT_COIN_ID=your_coin_id_here

2.添加产品图片

将产品图片放在 assets/ 目录：

• tshirt-black.png
• tshirt-white.png
• hoodie-black.png
• mug-classic.png
• cap-black.png

3.使用Docker Compose运行

docker compose up -d

4.查看日志

docker compose logs -f

测试MCP

MCP检查员

npx @modelcontextprotocol/inspector

然后在浏览器UI中，选择“SSE”传输并输入URL： http://localhost:3001/sse

健康检查

curl http://localhost:3001/health

工作流示例

1. 用户列出可用产品：

   Tool: list_products

1. 用户查看带有图像的产品：

   Tool: get_product
   Args: { "product_id": "tshirt-black" }

1. 用户下订单：

   Tool: place_order
   Args: { "unicity_id": "alice", "product_id": "tshirt-black", "quantity": 1, "size": "M" }

1. 付款请求已发送。 用户在其Unicity钱包中收到付款请求。

1. 用户确认付款：

   Tool: confirm_order
   Args: { "unicity_id": "alice", "order_id": "abc123" }

1. 成功付款后，订单即被确认。

配置

发展

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

# Watch mode
npm run dev

许可证

麻省理工学院