详细介绍
概览
Printful MCP（Purple-Horizons/printful-mcp）是面向 Printful 按需印刷 API 的 Python Model Context Protocol 服务器。目标用户是需要目录浏览、订单管理、样机生成、物流辅助与店铺分析、又不想手写 Printful REST 的 Claude Desktop、Cursor 及其他 MCP 宿主。
README 描述了偏生产向的细节：Pydantic 校验、限速处理、JSON/Markdown 双输出、默认 stdio 以及 HTTP/SSE 传输，还有可选的 Cursor Skill 用于教 Agent 正确使用这些工具。
主要功能
- Printful API v2 覆盖： 横跨目录、订单、履约与分析的较广工具集（README 称约 17 个工具）。
- 样机与目录： 浏览商品并为 POD 选品工作流生成样机。
- 订单自动化： 在助手会话中创建并管理 Printful 订单。
- 物流辅助： 面向履约规划的运费/物流相关工具。
- 传输选项： 桌面编辑器用 stdio；远程客户端可用 HTTP/SSE。
- Cursor Skill： 内置指引，帮助 Agent 更可靠地应用 Printful 工作流。
如何使用
- 安装兼容 MCP 的客户端（Claude Desktop、Cursor、Claude Code 等）。
- 从 https://github.com/Purple-Horizons/printful-mcp 克隆或安装服务器，按 README 完成构建 /
npx/ Docker。 - 在对应平台申请 API 凭证，写入 MCP 的
env，切勿把密钥提交到 Git。 - 在客户端 MCP 配置（如 Claude Desktop 的
claude_desktop_config.json或 Cursor 的mcp.json）中注册该服务器，然后重启客户端。 - 先用只读问题验证；确认权限与确认开关后再启用写入类工具。
定价
| 方案 | 计费 | 价格 | 说明 |
|---|---|---|---|
| printful-mcp | — | 免费（开源，README 徽章为 MIT） | Python 3.10+；需要 PRINTFUL_API_KEY |
| Printful | 按 Printful 产品/履约 | 视情况而定 | POD 生产与物流由 Printful 计费 |
适用人群
使用 Printful 的 POD 卖家与代理商，希望在选品会话中用 Claude/Cursor 上架产品、核对库存/价格或提交订单。
常见问题
是官方 Printful MCP 吗？
这是 Purple Horizons 使用 Printful 公开 API 的社区项目——README 品牌表述并未将其标为 Printful 官方 MCP。
如何安装？
克隆仓库，pip install -e .，设置 PRINTFUL_API_KEY，然后在 Cursor/Claude MCP 配置中注册 python -m printful_mcp 命令。
v1 与 v2？
README 声称支持 API v2，并对旧功能做智能 v1 回退。
联盟链接说明？
上游 README 可能含 Printful 注册推荐链接；FlowCay 不会自动追加联盟参数，除非你另行提供。