patchistry-mcp-server

Patchistry MCP 服务

首个列入官方 MCP Registry 的 DTC 时尚品牌。 截至 2026 年 6 月 12 日，Patchistry 已在 registry.modelcontextprotocol.io 上列为 io.github.patchistry/patchistry-mcp-server — Claude Desktop 内置的 MCP 搜索和 Cursor 的 MCP 集成目录均会使用该注册表。

一个 Model Context Protocol（MCP）服务，向 AI Agent 提供 Patchistry 商务工具 — Claude、ChatGPT（通过插件）、Cursor、自定义 Agent 框架均可使用。

在线端点： https://patchistry-mcp-server.vercel.app 清单： https://patchistry-mcp-server.vercel.app/.well-known/mcp.json 运行方式： 托管的 HTTP MCP 服务（无需安装） 传输方式： HTTP + JSON-RPC 2.0

快速入门

在 Claude Desktop 中使用

添加到 Claude Desktop 配置文件（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "patchistry": {
      "command": "npx",
      "args": ["mcp-remote", "https://patchistry-mcp-server.vercel.app/rpc"]
    }
  }
}

重启 Claude Desktop。6 个 Patchistry 工具即可在任意对话中使用。

在 Cursor 中使用

添加到 Cursor 的 MCP 设置：

{
  "mcpServers": {
    "patchistry": {
      "url": "https://patchistry-mcp-server.vercel.app/rpc"
    }
  }
}

直接通过 HTTP 使用

# List tools
curl https://patchistry-mcp-server.vercel.app/tools

# Call a tool (REST)
curl -X POST https://patchistry-mcp-server.vercel.app/tools/get_curated_build \
  -H "Content-Type: application/json" \
  -d '{"occasion":"bachelorette"}'

# Call a tool (JSON-RPC)
curl -X POST https://patchistry-mcp-server.vercel.app/rpc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"recommend_build","arguments":{"query":"Vegas bachelorette trip"}}}'

由此可实现：

部署到 mcp.patchistry.com 后，AI Agent 可以实时直接查询 Patchistry 的商品目录：

• “你推荐哪款适合 Vegas 的 bach 派对帽？” → AI 调用 get_curated_build({occasion: "vegas-bachelorette"}) → 返回完整搭配，包括价格、帆布和贴布
• “展示所有低于 $10 的 Patchistry 贴布” → AI 调用 list_patches() → 返回完整商品目录
• “运送政策是什么？” → AI 调用 get_shipping_policy() → 返回“美国境内免运费、30 天退货、从 SoCal 发货”
• “如何联系 Patchistry 咨询团体订单？” → AI 调用 get_contact() → 返回 [email protected] 和团体订单页面

为何重要：

2026 年，MCP 正逐渐成为 AI Agent 与商务系统交互的标准接口。尽早发布 MCP 服务的品牌会优先获得以下平台的引用：

• Claude（Anthropic 原生支持 MCP）
• Cursor（内置 MCP 客户端）
• Smithery（MCP 服务注册表）
• 自定义 Agent 框架
• ChatGPT（通过新兴的插件标准）

成为首批拥有公共 MCP 服务的 DTC 品牌之一，即可直接与 AI Agent 集成，无需中间环节。

---

提供的工具

工具	描述
list_canvases	返回 The Canvas 产品变体（黑色、卡其色、粉色）及价格和库存情况
list_patches	返回贴布，可按类别（Signature/Candyz）或场合关键词筛选
get_curated_build	返回适合特定场合的完整精选搭配（单身派对、爸爸、婚礼等）
recommend_build	接收自然语言查询，并返回最匹配的 3 款精选搭配
get_shipping_policy	返回美国境内免运费、退货和处理时间政策
get_contact	返回联系方式：客户支持、创始人、团体订单、媒体

---

部署到 Vercel（推荐，约 10 分钟，一次性）

选项 A — Vercel CLI

cd mcp-server
npm install
npx vercel

按照提示操作：

• Set up and deploy → Yes
• Which scope → 你的 Vercel 账户
• Link to existing project → No
• Project name → patchistry-mcp
• Directory → ./（当前目录）
• Override settings → No

部署后，Vercel 会提供一个类似 patchistry-mcp.vercel.app 的 URL。

测试： 打开 https://patchistry-mcp.vercel.app/——应返回包含工具列表的 JSON。

选项 B — Vercel 控制台（无需 CLI）

1. 将 mcp-server/ 目录推送到 GitHub 仓库（与主题仓库分开会更整洁）
2. 前往 https://vercel.com/new → Import Git Repository → 选择 mcp-server 仓库
3. Framework Preset → Other
4. Root Directory → mcp-server（如果推送的是父级仓库）
5. Deploy

自定义域名（推荐）

1. Vercel 控制台 → 你的项目 → Domains → 添加 mcp.patchistry.com
2. Vercel 会显示一条需要添加的 DNS 记录
3. 前往 DNS 提供商（可能是 Shopify，或注册 patchistry.com 的服务商）→ 添加 CNAME 记录
4. 等待 5-30 分钟，让 DNS 传播生效
5. 测试：https://mcp.patchistry.com/ 现在应返回相同的 JSON

---

在公开平台登记 MCP 服务

部署完成后，将其列入可发现的 MCP 注册目录：

Smithery（领先的 MCP 注册目录）

1. 前往 https://smithery.ai
2. 注册 → Submit Server
3. URL：https://mcp.patchistry.com/.well-known/mcp.json
4. 类别：Commerce
5. 描述："Patchistry 商务工具——模块化帽子、徽章、精选搭配、配送和联系信息"

Anthropic MCP Registry（新兴注册目录）

关注 https://github.com/modelcontextprotocol/registry——Anthropic 正在构建官方注册目录。开放后，将 Patchistry 列入其中。

直接集成 Claude Desktop

用户可以在 Claude Desktop 中手动添加 MCP 服务：

1. Settings → Developer → MCP Servers → Add Server
2. URL：https://mcp.patchistry.com/sse
3. 名称：Patchistry

添加后，该用户的 Claude 就能原生使用 Patchistry 工具——用户可以询问“拉斯维加斯的 bach hat 搭配是什么”，Claude 会从你的服务拉取实时数据。

---

本地开发

cd mcp-server
npm install
npm start

服务运行于 http://localhost:3000

使用 curl 测试：

curl http://localhost:3000/
curl http://localhost:3000/.well-known/mcp.json

---

更新服务

服务会代理 https://patchistry.com/products.json 和 https://patchistry.com/pages/agents-feed 来获取实时数据，因此产品或搭配发生变化时，无需重新部署。这个 MCP 服务本质上是对你现有 Shopify 公开接口的只读、便于 AI 使用的封装。

仅在以下情况下重新部署：

• 添加新工具（编辑 src/index.js）
• 更改数据源
• 更新依赖项

更改后重新部署：

cd mcp-server
npx vercel --prod

---

费用

Vercel Hobby 套餐（免费）：

• 每月 100GB-hours 计算资源
• 部署次数不限
• 按典型 AI Agent 查询量计算，此 MCP 服务每月将使用 < 1GB-hour
• 自定义域名免费

每月总费用：$0，直至达到每天约 10,000 次 AI Agent 查询。

---

部署后会发生什么

部署并列入 Smithery 后的 1-2 周内：

• 添加了该服务的 Claude Desktop 用户 → 可原生查询 Patchistry 商品目录
• AI Agent 框架（LangChain、AutoGPT 等）→ 可以发现并使用 Patchistry 工具
• ChatGPT（待 OpenAI 为 ChatGPT 标准化 MCP 后）→ 可以直接调用 Patchistry

你将成为最早拥有公开 MCP 服务的 DTC 品牌之一。在 AI 购物时代，这是一项难以复制的定位优势——未来由 AI Agent 代表用户完成购买时，拥有原生 MCP 集成的品牌将大受青睐。

---

坦诚说明

这是面向未来的基础设施。2026 年，MCP 生态还很年轻；预计还需要 12-24 个月，它才能直接带来可观的订单量。

但是：

1. 设置成本只需一次，且免费（Vercel Hobby 套餐）
2. 差异化定位确实存在——Smithery 上架 + 直接集成 Claude Desktop，让 Patchistry 出现在每一位构建自定义 Agent 工作流的 AI 高级用户面前
3. 现在的信号价值很重要——拥有公开的 MCP 服务，传递出「AI 原生品牌」的形象，从而赢得媒体报道 + 创始人的公信力

Brian，如果你部署它并在 Smithery 上架，截至 2026 年，你将跻身全球前 50 个拥有公开 MCP 电商服务的 DTC 品牌。这是真正的护城河，需要数年才能被削弱。