# @apparelhub/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40apparelhub/mcp-server/

版本：0\.20\.0
npm 元数据更新时间：2026-10-26T17:15:12.992Z
中文译文更新时间：2026-11-06T22:54:19.208Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40apparelhub/mcp-server
原文对照：https://npmcn.com/package/%40apparelhub/mcp-server/?lang=original
项目主页：https://apparelhub.ai/agents
源码仓库：https://github.com/ApparelHub-AI/apparelhub-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：782 kB，92 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-07-02T22:19:14.620Z
- 最新版本发布：2026-10-26T17:15:11.896Z
- 近 30 天下载量：2199（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：93（近 12 个月 93 个）

## 中文简介

ApparelHub MCP服务器:工作流程级工具,可以让一个AI代理设计服装,构建出产品,并通过ApparelHub平台同步到销售渠道.

## 安装

```sh
npm install @apparelhub/mcp-server
```

也可以使用：`pnpm add @apparelhub/mcp-server`、`yarn add @apparelhub/mcp-server`、`bun add @apparelhub/mcp-server`

## README

# @apparelhub/mcp-服务器

工作流量 [MCP 磁共振](https://modelcontextprotocol.io/) 让AI代理运行的工具 ApparelHub商店结束: 设置它, 设计服装, 制作产品, 列出销售范围 并执行命令 和名单 回来。 每个工具都包围 [外观HUB代理 API](https://apparelhub.ai/agents) 和烤 在平台的来之不易 制作课程,所以代理 得到正确的行为免费 而不是学习的catchs 自己来.

有两种方式运行它: **您与 OAuth 授权的连接器** (建议,无 API 处理键)和此 **npm 包您自己运行** 有钥匙 两者都服务于相同的工具 表面.

> **状态:早期访问.** Npm包为前1.0,而表面稳定. 这个 介绍代理 **工具表面为 v1** 那是我们所遵守的盟约 [`CHANGELOG.md`](https://npmcn.com/package/%40apparelhub/mcp-server/CHANGELOG.md) 财务报告和审定财务报表 [版本](https://npmcn.com/package/%40apparelhub/mcp-server/#readme-versioning--stability)) (中文(简体) ).

## 是什么让这不同

一个薄薄的包裹环绕一个REST API 只是重命名 HTTP 呼叫。 这些工具正在 **工作流程 职等**页:1 `ship_product` 调用解析变体,生成并等待模拟(通过 等待其图像实际发布),用正确的字段名称创建产品, 添加每个变体, 把它和商店联系起来 同步实现 并按正确的顺序通过频道 拒绝 对沿途已知变种陷阱的负边际价格和警告。 伤疤组织生活在 代码,不是在你的经纪人的背景.

## 连接

**更喜欢主机连接器.** 授权它为您提供 API 密钥, 所以没有 证书可以创建、粘贴、旋转或漏入配置文件。 到达自运行软件包 只当您的客户端不能说远程 MCP 或 OAuth, 或者当您特别想要服务器时 运行在自己的机器.

|  | 主机连接器( OAuth) | 自运行软件包( API 密钥) |
| --- | --- | --- |
| 证书 | 供你批准时使用 | 您创建并粘贴 API 密钥 |
| 当地先决条件 | 无 | 节点.js 20+, Python 3 + Pillow, 可选的语法 |
| 运输 | 通过 HTTP 远程 MCP | 静态 |
| 最好还是 | 任何支持远程 MCP 的客户端 | 没有远程/OAuth支持的客户端,本地控制,开发 |

### 建议:主机连接器

```
https://mcp.apparelhub.ai
```

将该 URL 添加到任何支持远程服务器的 MCP 客户端, 签名到 ApparelHub, 并批准 . **你从来不处理API密钥.** 批准您账户上的连接键 (或重用你已经拥有的,),而主机服务器在每一个 电话 没有粘贴,没有手旋转, 没有坐在点文件.

主机服务器还搭载成像工具链 设计和质量工具需要,所以 透明密钥、图像统计和OCR都与 **完全没有本地附属关系**: 无 节点,没有活塞,没有活塞,没有活塞.

**克劳德代码**

```bash
claude mcp add --transport http apparelhub https://mcp.apparelhub.ai
```

然后运行 `/mcp` 选择 **认证**。 。 。 .

**任何读取 MCP 配置文件的客户端**

```jsonc
{
  "mcpServers": {
    "apparelhub": {
      "type": "http",
      "url": "https://mcp.apparelhub.ai"
    }
  }
}
```

**克劳德. 艾** ——在设置下添加为自定义连接器 + 连接器,粘贴相同的 URL,然后 通知时授权.

上面的赤出自服务器的犬形地址: `resource` 标识它自己的 OAuth元数据广告. 路径未被路由, 因此已有配置指向 `https://mcp.apparelhub.ai/mcp` 继续工作,不需要改变.

#### 握手会做什么

标准 OAuth 2.1, 您没有自定义配置 。 您的客户端发现了授权 服务器从 `/.well-known/oauth-protected-resource` (RFC 9728),动态登记,以及 与 PKCE 运行授权码流(`S256`用于 `mcp` 范围相对 `https://api.apparelhub.ai`。支持刷新令牌和撤销。 访问符号不透明 : 主机服务器交换您的连接器密钥服务器侧, 因此密钥永远不会在您的 客户端、您的配置或您的聊天历史.

#### 键位和撤销

一个连接器密钥是每个账户的薄荷, 并共享在您给予的每一个聊天面, 它 以你的计划为单位计算 自由计划包含一个插槽的API访问,所以 如果一个自助密钥已经占据了这个插槽 同意屏幕就这么说了 并且提供了免费 或升级。 取消、断开持有赠款的客户端,或删除连接器 键在 [https://apparelhub.ai/developer/api-keys (英语)](https://apparelhub.ai/developer/api-keys)。 。 。 .

### 选项: 自己运行软件包

所需经费:

-   **节点.js 20+**。 。 。 .
-   一个 **ApparelHub 账户和 API 密钥** - 生成一个在 [https://apparelhub.ai/developer/api-keys (英语)](https://apparelhub.ai/developer/api-keys)。 。 。 .
-   仅用于设计+质量工具: **Python 3 有枕头** (透明密钥,图像QC) 选择 **语法** (OCR文本检测). 这些是本地运行的,如果它们不见了,那些 工具返回一个明确的通知,告诉你要安装什么,并且永远不要崩溃.

服务器读取您的密钥 `APPARELHUB_API_KEY` 启动和发言时的环境变量 MCP过 stdio。 它从不接受密钥作为工具参数,API主机被绑定( 否) 覆盖).

#### 克劳德代码

```jsonc
// ~/.claude/mcp.json (or a project .mcp.json)
{
  "mcpServers": {
    "apparelhub": {
      "command": "npx",
      "args": ["-y", "@apparelhub/mcp-server"],
      "env": { "APPARELHUB_API_KEY": "your-key-here" }
    }
  }
}
```

#### 光标

```jsonc
// .cursor/mcp.json
{
  "mcpServers": {
    "apparelhub": {
      "command": "npx",
      "args": ["-y", "@apparelhub/mcp-server"],
      "env": { "APPARELHUB_API_KEY": "your-key-here" }
    }
  }
}
```

#### 助手

```yaml
# .aider.conf.yml
mcp-servers:
  apparelhub:
    command: npx
    args: ["-y", "@apparelhub/mcp-server"]
    env:
      APPARELHUB_API_KEY: your-key-here
```

#### 任何其他 MCP 客户端

各地形状相同: 运行 `npx -y @apparelhub/mcp-server` 与 `APPARELHUB_API_KEY` 联合国 环境.

#### 环境变量

| 变量 | 目的 |
| --- | --- |
| `APPARELHUB_API_KEY` | **要求.** 您的 ApparelHub API 密钥 。 在主机连接器上不需要. |
| `APPARELHUB_MCP_TELEMETRY` | 设定为 `off` 以禁用粗旧信号(参见 [隐私](https://npmcn.com/package/%40apparelhub/mcp-server/#readme-privacy)) (中文(简体) ). |
| `APPARELHUB_MCP_PYTHON` | 本地图像工具的 Python 3 解释器路径( 默认) `python3`) (中文(简体) ). |

## 工具

127个工具. [`docs/TOOLS.md`](https://npmcn.com/package/%40apparelhub/mcp-server/docs/TOOLS.md) 穿过核心组;呼叫 `tools/list` 从 你的代理 权威的现场计划.

-   **设置连接( C)** —— 说 `check_setup_readiness` (账户有什么,它需要什么,单 下一个行动, `list_connectable_providers`, (中文(简体) ), `connect_fulfillment_provider` 财务报告和审定财务报表 `connect_sales_channel` (API- token 提供者完全在聊天中连接),加 `start_channel_connect` 编号 : `check_connection_status` 对于基于浏览器的浏览器(printful, (原始内容存档于2018-10-21). Shopify, TikTok Shop, Fourthwall.
-   **读取** —— 说 `list_my_workspaces`, (中文(简体) ), `list_my_stores`, (中文(简体) ), `list_my_designs`, (中文(简体) ), `get_design_collection`, (中文(简体) ), `list_my_products`, (中文(简体) ), `list_my_orders`, (中文(简体) ), `get_order_details`。 。 。 .
-   **目录** —— 说 `browse_catalog`, (中文(简体) ), `get_garment_details`, (中文(简体) ), `find_garments` (搜索每个连接 (一) 提供商即刻具备某种能力, `recommend_garment`, (中文(简体) ), `list_catalog_providers`。 。 。 .
-   **设计** —— 说 `design_apparel`, (中文(简体) ), `iterate_design`, (中文(简体) ), `upload_design` (画出商人) 已经拥有, `fit_aspect` 设计寿命周期(无配额重塑)`archive_design`, (中文(简体) ), `restore_design`, (中文(简体) ), `delete_design`和分裂的原始人 `generate_image`, (中文(简体) ), `process_transparency`, (中文(简体) ), `verify_design_text`。 。 。 .
-   **产品** —— 说 `ship_product`, (中文(简体) ), `update_product`, (中文(简体) ), `delete_product`, (中文(简体) ), `unsync_from_channel`, (中文(简体) ), `diagnose_tiktok_listings`和分裂原始人 `create_product`, (中文(简体) ), `add_variants`, (中文(简体) ), `sync_to_fulfillment`, (中文(简体) ), `sync_to_channel`。 。 。 .
-   **命令** 寿命周期`approve_order`, (中文(简体) ), `unapprove_order`, (中文(简体) ), `hold_order`, (中文(简体) ), `cancel_order`, (中文(简体) ), `confirm_order`, (中文(简体) ), `submit_order_to_fulfillment`, (中文(简体) ), `check_order_status`, (中文(简体) ), `reconcile_order`, (中文(简体) ), 编辑草稿( e)`add_order_item`, (中文(简体) ), `remove_order_item`)),并持有设计批准书 (单位:千美元)`list_order_holds`, (中文(简体) ), `approve_order_hold`, (中文(简体) ), `request_hold_changes`) (中文(简体) ).
-   **履行问题** —— 说 `report_fulfillment_issue` (在命令中报告缺陷), `list_fulfillment_issues` (每个订单或整个工作空间的收件箱), `check_fulfillment_issue` (全额) 问题报告, `resolve_fulfillment_issue` (记录提供者) 存档、以解析器关闭或创建替换命令).
-   **频道情报** ——销售渠道本身的报告内容和可以设置的内容: `channel_performance`, (中文(简体) ), `channel_opportunities`, (中文(简体) ), `channel_coverage`, (中文(简体) ), `listing_changes` (对 最后编辑实际工作), `describe_listing_attributes`, (中文(简体) ), `set_listing_attributes`, (中文(简体) ), `set_channel_settings`, (中文(简体) ), `import_size_measurements`。 。 。 .
-   **目录导入( 跟踪列表)** - 带一个商人在频道上已经卖的东西进来, 只读 : `import_channel_catalog` (启动;如果有,则返回已运行), `get_catalog_import_run` (民谣), `list_tracked_listings` (列表加上每个频道的) `catalog_read` 和最后运行。 商家的店铺和那些产品都没写 保持今天的运输。 (原始内容存档于2018-10-25). Shopify, WooCommerce, Wix and TikTok Shop. 让ApparelHub完成一个, `bind_tracked_listing` 将其与ApparelHub产品相接(其清单不变); `unbind_tracked_listing` 撤销它.
-   **分析** —— 说 `analytics_summary`, (中文(简体) ), `analytics_timeseries`, (中文(简体) ), `analytics_breakdown`, (中文(简体) ), `analytics_ops`, (中文(简体) ), `analytics_portfolio`。 。 。 .
-   **收款** —— 说 `list_collections`, (中文(简体) ), `get_collection`, (中文(简体) ), `create_collection`, (中文(简体) ), `update_collection`, (中文(简体) ), `delete_collection`, (中文(简体) ), `add_products_to_collection`, (中文(简体) ), `remove_product_from_collection`, (中文(简体) ), `sync_collection`。 。 。 .
-   **跨工作空间传输** —— 说 `copy_product_to_workspace`, (中文(简体) ), `move_product_to_workspace`, (中文(简体) ), `check_product_move`,和设计等同.
-   **工作空间和团队管理** (机构/企业,全账户钥匙)——工作空间 (单位:千美元)`create_workspace`, (中文(简体) ), `update_workspace`, (中文(简体) ), `delete_workspace`, (中文(简体) ), `check_workspace_deletion`, (中文(简体) ), `assign_workspace_member`, (中文(简体) ), `unassign_workspace_member`, (中文(简体) ), `move_store_to_workspace`, (中文(简体) ), `get_role_matrix`)和团队(`get_account_overview`, (中文(简体) ), `list_account_members`, (中文(简体) ), `remove_member`, (中文(简体) ), `invite_member`, (中文(简体) ), `list_invites`, (中文(简体) ), `revoke_invite`, (中文(简体) ), `resend_invite`, (中文(简体) ), `accept_invite`) (中文(简体) ).
-   **存储订单管理( L)** 储存设置/生命周期(`get_store_settings`, (中文(简体) ), `update_store_settings`, (中文(简体) ), `create_store`, (中文(简体) ), `archive_store`, (中文(简体) ), `unarchive_store`, (中文(简体) ), `activate_store`, (中文(简体) ), 定单付款/业务费`record_order_payment`, (中文(简体) ), `mark_order_no_payment`, (中文(简体) ), `set_order_payment_method`, (中文(简体) ), `sync_orders`, (中文(简体) ), `estimate_order_costs`, (中文(简体) ), `get_orders_summary`, (中文(简体) ), `list_pending_fulfillments`),以及 `archive_product` 编号 : `restore_product`。 。 。 .
-   **行动系统** —— 说 `analyze_what_works`, (中文(简体) ), `auto_optimize_listings`, (中文(简体) ), `cascade_price_change`, (中文(简体) ), `set_prices_by_margin`, (中文(简体) ), `recover_from_outage`。 。 。 .
-   **安全问题** —— 说 `verify_design_quality`, (中文(简体) ), `verify_mockup_quality`, (中文(简体) ), `check_design_compliance`。 。 。 .
-   **API 逃生舱门** —— 说 `get_api_reference` (从现场OpenAPI中发现完整的代理API) 类别)和 `api_request` (呼叫任何 `/agents/v1` 当没有专用工具适合时,结束点).

读取工具只读取. 产品和设计工具默认为 **草稿,永远不要活**执行 定价楼层,并守卫已知的变种陷阱. 行动系统变异默认为 **干线运行** 并只在应用时采取安全行动(存档,永不删除)。 每个产品/订单/储存结果 携带一个 `view_url` 回到服装胡同 错误以一致的形状出现 (单位:千美元)`{error: {code, message, retry_after?, suggestion?}}`)——工具从不扔出过MCP边界.

`get_api_reference` 还报告您实际要服务的服务器的版本, 工具计数,以及每个工具名——因此,除了"我的"之外,一个代理可以告诉"那个工具不存在" 缓存的工具列表是 stale"而不是猜测.

## 隐私

一个可选而粗糙的使用信号有助于改进工具. 它发出 **仅限** 未识别 特性——工具名、结果、耐用性、出错代码和粗细字段严格允许列表 (例如AI源名,服装类). 这个 **永远** 发送提示、图像、 ID、 URL 或客户端 数据。 它具有缓冲和起火和遗忘的作用(它永远不能影响工具呼叫). 完全关掉 与 `APPARELHUB_MCP_TELEMETRY=off`。 。 。 .

主机连接器额外记录了每个请求一个操作度量(结果、延迟和 为工具调用工具名。 它没有每个身份的尺寸,也没有用户数据.

## 技能对MCP对食谱

外壳Hub以三种形式出海:

-   这个 **[减记技能](https://github.com/ApparelHub-AI/apparelhub-skills)** 这是 使用 Claude 代码的 ApparelHub 的最小冷冻方式 —— 它教给代理人 REST API 和 设计规则直接.
-   这个 **MCP 服务器** 将知识转换成可打字的可调用工具表面(带有 (c) 能够跨越任何多氯乙烯的代理商,并通过东道方 连接器,在聊天表层中,完全无法运行一个技能或本地进程.
-   这个 **[食谱](https://github.com/ApparelHub-AI/apparelhub-recipes)** 正在运行端到端 蓝图,你掉进你经纪人的运行时间: 特许代理遵循, 内存模型它 不停地运行, 和提示启动它。 他们驾驶这个工具表面,用钱和 默认情况下会打开门.

使用 Claude 代码中的快速启动技巧; 需要输入工具时使用 MCP 服务器, 即 更高排序的工作流程,或克劳德代码以外的客户端;需要代理时使用配方 运行整个存储模式,而不是一次回答一个请求.

## 发展

```bash
npm ci
npm run build      # tsc -> dist/
npm run typecheck
npm run lint
npm test           # vitest
```

图像工具外壳以捆绑 Python 脚本 [`python/`](https://npmcn.com/package/%40apparelhub/mcp-server/python); 成像层是 注射,所以工具管弦乐用假的单位测试 脚本用烟雾测试 直接说.

## 版本稳定性( S)

这个 **工具表面** 与软件包(这是v1)分开。 当基础 REST API进化,服务器在内部调整——代理-造型工具名+形状保持稳定. 这份合同让你安装一次 继续工作 软件包发布如下 [语义版本](https://semver.org/); 见 [`docs/RELEASING.md`](https://npmcn.com/package/%40apparelhub/mcp-server/docs/RELEASING.md)。 。 。 .

在主机连接器上, 您总是在当前的版本上, 这是另一个选择的原因 它: 新的工具出现时你没有升级任何东西。 客户端缓存工具列表, 所以询问 `get_api_reference` 如果你怀疑你的已经落后.

## 许可证

麻省理工学院 见 [`LICENSE`](https://npmcn.com/package/%40apparelhub/mcp-server/LICENSE)。 。 。 .

## 常见问题

### @apparelhub/mcp-server 是什么？

ApparelHub MCP服务器:工作流程级工具,可以让一个AI代理设计服装,构建出产品,并通过ApparelHub平台同步到销售渠道\.

### 如何安装 @apparelhub/mcp-server？

在项目目录运行 npm install @apparelhub/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 apparelhub-mcp，可以用 npx apparelhub-mcp 直接运行。

### @apparelhub/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @apparelhub/mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @apparelhub/mcp-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @apparelhub/mcp-server 可以商用吗？

@apparelhub/mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @apparelhub/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@apparelhub/mcp-server 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,199 次，日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @apparelhub/mcp-server 还在维护吗？

最新版本 0\.20\.0 发布于 2026/10/27（12 天前）；至今共发布 93 个版本，其中过去 12 个月发布了 93 个；首次发布于 2026/07/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。