@apparelhub/mcp-服务器
工作流量 MCP 磁共振 让AI代理运行的工具 ApparelHub商店结束: 设置它, 设计服装, 制作产品, 列出销售范围 并执行命令 和名单 回来。 每个工具都包围 外观HUB代理 API 和烤 在平台的来之不易 制作课程,所以代理 得到正确的行为免费 而不是学习的catchs 自己来.
有两种方式运行它: 您与 OAuth 授权的连接器 (建议,无 API 处理键)和此 npm 包您自己运行 有钥匙 两者都服务于相同的工具 表面.
状态:早期访问. Npm包为前1.0,而表面稳定. 这个 介绍代理 工具表面为 v1 那是我们所遵守的盟约
CHANGELOG.md财务报告和审定财务报表 版本) (中文(简体) ).
是什么让这不同
一个薄薄的包裹环绕一个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都与 完全没有本地附属关系: 无 节点,没有活塞,没有活塞,没有活塞.
克劳德代码
claude mcp add --transport http apparelhub https://mcp.apparelhub.ai
然后运行 /mcp 选择 认证。 。 。 .
任何读取 MCP 配置文件的客户端
{
"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 (英语)。 。 。 .
选项: 自己运行软件包
所需经费:
- 节点.js 20+。 。 。 .
- 一个 ApparelHub 账户和 API 密钥 - 生成一个在 https://apparelhub.ai/developer/api-keys (英语)。 。 。 .
- 仅用于设计+质量工具: Python 3 有枕头 (透明密钥,图像QC) 选择 语法 (OCR文本检测). 这些是本地运行的,如果它们不见了,那些 工具返回一个明确的通知,告诉你要安装什么,并且永远不要崩溃.
服务器读取您的密钥 APPARELHUB_API_KEY 启动和发言时的环境变量
MCP过 stdio。 它从不接受密钥作为工具参数,API主机被绑定( 否)
覆盖).
克劳德代码
// ~/.claude/mcp.json (or a project .mcp.json)
{
"mcpServers": {
"apparelhub": {
"command": "npx",
"args": ["-y", "@apparelhub/mcp-server"],
"env": { "APPARELHUB_API_KEY": "your-key-here" }
}
}
}
光标
// .cursor/mcp.json
{
"mcpServers": {
"apparelhub": {
"command": "npx",
"args": ["-y", "@apparelhub/mcp-server"],
"env": { "APPARELHUB_API_KEY": "your-key-here" }
}
}
}
助手
# .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 以禁用粗旧信号(参见 隐私) (中文(简体) ). |
APPARELHUB_MCP_PYTHON | 本地图像工具的 Python 3 解释器路径( 默认) python3) (中文(简体) ). |
工具
127个工具. 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以三种形式出海:
- 这个 减记技能 这是 使用 Claude 代码的 ApparelHub 的最小冷冻方式 —— 它教给代理人 REST API 和 设计规则直接.
- 这个 MCP 服务器 将知识转换成可打字的可调用工具表面(带有 (c) 能够跨越任何多氯乙烯的代理商,并通过东道方 连接器,在聊天表层中,完全无法运行一个技能或本地进程.
- 这个 食谱 正在运行端到端 蓝图,你掉进你经纪人的运行时间: 特许代理遵循, 内存模型它 不停地运行, 和提示启动它。 他们驾驶这个工具表面,用钱和 默认情况下会打开门.
使用 Claude 代码中的快速启动技巧; 需要输入工具时使用 MCP 服务器, 即 更高排序的工作流程,或克劳德代码以外的客户端;需要代理时使用配方 运行整个存储模式,而不是一次回答一个请求.
发展
npm ci
npm run build # tsc -> dist/
npm run typecheck
npm run lint
npm test # vitest
图像工具外壳以捆绑 Python 脚本 python/; 成像层是
注射,所以工具管弦乐用假的单位测试 脚本用烟雾测试
直接说.
版本稳定性( S)
这个 工具表面 与软件包(这是v1)分开。 当基础
REST API进化,服务器在内部调整——代理-造型工具名+形状保持稳定.
这份合同让你安装一次 继续工作 软件包发布如下
语义版本; 见 docs/RELEASING.md。 。 。 .
在主机连接器上, 您总是在当前的版本上, 这是另一个选择的原因
它: 新的工具出现时你没有升级任何东西。 客户端缓存工具列表, 所以询问
get_api_reference 如果你怀疑你的已经落后.
许可证
麻省理工学院 见 LICENSE。 。 。 .