内容
istry MCP 服务器
[](https://registry.modelcontextprotocol.io/v0/servers?search=patchistry)
[](https://www.npmjs.com/package/patchistry-mcp-server)
[](https://smithery.ai/servers/@patchistry/patchistry-commerce)
[](https://www.wikidata.org/wiki/Q140179620)
[](https://modelcontextprotocol.io)
[](https://patchistry-mcp-server.vercel.app)
[](LICENSE)
> **第一个 DTC 时尚品牌，登录官方 MCP 注册表。**截至 2026 年 6 月 12 日，Patchistry 在.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/v0/servers?search=patchistry) 上列为 `io.github.patchistry/patchistry-mcp-server` — 由 Claude Desktop 内置的 MCP 搜索和 Cursor 的 MCP 集成目录使用。
一个 Model Context Protocol（MCP）服务器，向 AI 代理（如 ClaudeGPT（通过插件）、Cursor、自定义代理框架）公开 Patchistry 商务工具。
**实时端点：** 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 配置文件（`~/Library/Application Support/Claude/claude_desktop_config.json` 在 macOS 上）：
```json
{
"mcpServers": {
"patchistry": {
"command": "npx",
"args": ["mcp-remote", "https://patchistry-mcp-server.vercel.app/rpc"]
}
}
}
```
重启 Claude Desktop。6 个 Patchistry 工具将可在任何对话中使用。
### 在 Cursor 中使用
将以下内容添加到 Cursor 的 MCP 设置中：
```json
{
"mcpServers": {
"patchistry": {
"url": "https://patchistry-mcp-server.vercel.app/rpc"
}
}
}
```
### 直接通过 HTTP 使用
```bash
# 列出工具
curl https://patchistry-mcp-server.vercel.app/tools
# 调用工具（REST）
curl -X POST https://patchistry-mcp-server.vercel.app/tools/get_curated_build \
-H "Content-Type: application/json" \
-d '{"occasion":"bachelorette"}'
# 调用工具（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 代理可以直接实时查询 Patchistry 的
- “你推荐什么样的 Vegas 派对帽子？” → AI 调用 `get_curated_build({occasion: "vegas-bachelorette"})` → 返回完整的构建，包含价格 + 画布 + 补丁
- “给我看看所有 Patchistry 价格低于 10 美元的补丁” → AI 调用 `list_patches()` → 返回完整的目录
- “运费政策是什么？” → AI 调用 `get_shipping_policy()` → 返回“美国境内免费运费，30 天退货，货品从南加州发货”
- “我如何联系 Patchistry 询问团体订单？” → AI 调用 `get_contact()` → 返回 `brian@patchistry.com` + 团体订单页面
**为什么这很重要：**
2026 年，MCP 正在成为 AI 代理与商务系统交互的标准接口。早期发布 MCP 服务器的品牌将优先被以下方式引用：
- Claude（Anthropic 的原生 MCP 支持）
- Cursor（内置 MCP 客户端）
- Smithery（MCP 服务器注册表）
- 自定义代理框架
- ChatGPT（通过新兴的插件标准）
成为首批具有公共 MCP 服务器的 DTC 品牌之一 = 直接 AI 代理集成，无需中间商。
---
## 暴露的工具
| 工具 | 描述 |
|---|---|
| `list_canvases` | 返回画布产品变体（黑色、卡其色、粉色）以及价格和可用性 |
| `list_patches` | 返回补丁，可选地按类别（Signature/Candyz）或场合关键词筛选 |
| `get_curated_build` | 返回场合的完整精选构建（bachelorette、dads、wedding 等） |
| `recommend_build` | 接受自然语言查询，返回 3 个匹配的精选构建 |
| `get_shipping_policy` | 返回美国境内免费运费 + 退货 + 交货时间政策 |
| `get_contact` | 返回联系方式：客户支持、创始人、团体订单、媒体 |
---
## 部署到 Vercel（推荐，约 10 分钟，一次性）
### 选项 A — Vercel CLI
```bash
cd mcp-server
npm install
npx vercel
```
按照提示进行操作：
- 设置并部署 → 是
- 选择范围 → 您的 Vercel 账户
- 链接到现有项目 → 否
- 项目名称 → `patchistry-mcp`
- `./`（当前）
-设置 → 否
部署后，Vercel 会一个类似 `patchistry.vercel.app` 的网址测试：** 打开 `https://-mcp.vercel.app/` — 应该返回包含工具 JSON。
### 选项 B — Vercel 仪表盘（无 CLI）
1. 将 `mcp-server/` 目录推送到 GitHub 仓库（与您的主题仓库分开）
2. https://vercel.com/new → 导入 Git 仓库 → 选择 mcp-server 仓库
3. 框架预设 → 其他
4. 根目录 → `mcp-server`（如果您推送了父仓库）
5. 部署
### 自定义域名（推荐）
1. Vercel 仪表盘 → 您的项目 → **域名** → 添加 `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. 注册 → 提交服务器
3. URL：`https://mcp.patchistry.com/.well-known/mcp.json`
4. 类别：商务
5. 描述：“Patchistry 商务工具 — 模块化帽子，补丁，精选构建，运费，联系信息”
### Anthropic MCP 注册表（新兴）
关注 https://github.com/modelcontextprotocol/registry — Anthropic 正在构建一个官方注册表。一旦可用，请在那里列出 Patchistry。
### 直接 Claude Desktop 集成
用户可以在 Claude Desktop 中手动添加 MCP 服务器：
1. 设置 → 开发者 → MCP 服务器 → 添加服务器
2. URL：`https://mcp.patchistry.com/sse`
3. 名称：Patchistry
添加后，该用户的 Claude 将原生使用 Patchistry 工具 — 他们可以询问“Vegas 派对帽子的构建是什么”，Claude 从您的服务器拉取实时数据。
---
## 本地开发
```bash
cd mcp-server
npm install
npm start
```
服务器运行在 http://localhost:3000
使用 curl 测试：
```bash
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`）
- 更改数据源
- 更新依赖项
在更改后重新部署：
```bash
cd mcp-server
npx vercel --prod
```
---
## 成本
Vercel 休闲版（免费）：
- 100GB 小时/月计算
- 无限部署
- 该 MCP 服务器在典型的 AI 代理查询量下将使用 < 1GB 小时/月
- 自定义域名免费
**总每月成本：$0**，直到您达到每天约 10,000 次 AI 代理查询。
---
## 部署后会发生什么
部署 + Smithery 上线后 1-2 周内：
- 添加了服务器的 Claude Desktop 用户 → 原生查询 Patchistry 目录
- AI 代理框架（LangChain、AutoGPT 等）→ 可以发现并使用 Patchistry 工具
- ChatGPT（一旦 OpenAI 为 ChatGPT 标准化 MCP）→ 可以直接调用 Patchistry
您将成为首批拥有公共 MCP 服务器的 DTC 品牌之一。这在 AI 购物时代是一个可防御的定位优势 — 未来 AI 代理将代表用户完成购买，拥有 MCP 原生集成的品牌将占据主导地位。
---
## 诚实框架
这是前瞻性基础设施。2026 年，MCP 生态系统仍处于初期阶段；预计 12-24 个月后，这将直接驱动显著的订单量。
但是：
1. **设置成本是一次性的且免费**（Vercel 休闲版）
2. **可防御的定位是真实的** — Smithery 上线 + 直接 Claude Desktop 集成使 Patchistry 出现在每个 AI 强大的用户构建自定义代理工作流的前沿
3. **信号值现在很重要** — 拥有公共 MCP 服务器表明“AI 原生品牌”，这值得媒体报道和创始人信誉
Brian，如果您部署并在 Smithery 上线，您将是 2026 年全球前 50 名 DTC 品牌中首个拥有公共 MCP 商务服务器的品牌。那是一个真正的护城河，需要数年时间才能稀释。
