AutoID Product Catalog & Support

AutoID MCP 服务 v0.3.1

通过 AutoID 规范 WordPress/WooCommerce API 提供的只读 MCP 服务。

此版本包含经 AutoID 规范 API 插件 v0.3.9 验证的产品、报价、分组变体和相关产品行为。

MCP 工具

• search_products
• get_product_group
• list_product_variants
• get_product
• get_product_offer
• get_related_products
• get_related_products_summary
• search_support
• fetch_support
• autoid_support_health
• autoid_api_health

信息来源

MCP 服务不会读取 WordPress SQL，也不会自行计算商业数据或兼容性数据。它从以下规范 API 读取数据：

https://www.autoid.ro/wp-json/autoid-ai/v1

权威商业字段：

• 精确 SKU 的 MSRP 欧元未含增值税：pret_lista
• 精确 SKU 的 AutoID 价格（欧元，未含增值税）：pret_autoid_euro
• 分组目录 MSRP：grp_pret_lista_mic
• 分组目录 AutoID 价格：grp_pret_autoid_mic
• AutoID 库存：stock_autoid
• 分销库存：stock_distributie

若要获取当前精确 SKU 的价格／库存信息，请使用 get_product_offer。面向罗马尼亚客户展示价格时，请使用规范的 ron_display 投影，并优先采用含增值税的数值。RON 数据来源于 WooCommerce _regular_price / _sale_price；请勿在 MCP 内将权威欧元价格换算为 RON。

RON 显示价格

规范 API v0.3.9 新增了精简的 RON 投影，且不改变商业数据的权威来源。

精确 SKU 卡片使用 pricing.ron_display；精确实时报价使用 price.ron_display。典型字段包括 msrp_ex_vat、msrp_inc_vat、autoid_ex_vat 和 autoid_inc_vat。分组产品使用 FROM 字段，例如 msrp_from_inc_vat 和 autoid_from_inc_vat。

规则：

• 面向罗马尼亚客户的回答：优先显示 RON inc_vat
• B2B／未含增值税的场景：也可显示 RON ex_vat
• 欧元 pret_lista / pret_autoid_euro 仍是商业数据的权威来源
• RON 数值是 WooCommerce 商店前台的显示／验证数据
• 切勿在 MCP 内通过对权威欧元价格应用汇率来计算 RON

相关产品约定

get_related_products 读取：

/wp-json/autoid-ai/v1/relations/{sku-or-model}

支持的关系类型：

• accessory - 纳入库存管理
• consumable - 纳入库存管理
• software - 不纳入库存管理
• service_contract - 不纳入库存管理
• all

兼容性仅依据规范 API 的 product_tag 证据。WooCommerce product_cat 用于判定相关实体属于配件、耗材、软件产品还是服务合同。

对于配件和耗材，MCP 默认使用 availability=available：

stock_autoid > 0 OR stock_distributie > 0

规范 API 会优先列出有 AutoID 库存的商品，其次是仅有分销库存的商品。缺货商品属于额外的目录信息，默认不会返回。仅在需要时请求 availability=out_of_stock 或 availability=all。

对于大量耗材，请使用精确的分类别名进行筛选。已验证的 ZT610 示例包括：

• ribboane-imprimanta
• role-de-etichete
• intretinere-imprimante

get_related_products_summary 会通过单项分页查询 availability=all，然后返回规范摘要的精简投影。使用此工具可获取兼容商品总数和缺货商品数，而无需将数百条目录商品加载到 MCP 上下文中。

已验证的数据集

验证时 MC9300 的完整关联图：

• 85 件配件
• 23 个软件实体 = 22 个精确 SKU + 1 个分组产品
• 130 份服务合同
• 0 件耗材
• 相关实体总计 238 个

验证时 ZT610 的完整关联图：

• 85 件配件
• 752 件耗材
• 29 个软件实体 = 28 个精确 SKU + 1 个分组产品
• 69 份服务合同
• 相关实体总计 935 个

验证时 ZT610 的耗材：

• 32 件有 AutoID 库存
• 206 件仅有供应商库存
• 514 件缺货

这些数字是验证时的快照，并非硬编码的生产数据。MCP 始终从实时规范 API 读取数据。

要求

• Node.js 20+
• 公网 HTTPS 主机名，推荐使用 mcp.autoid.ro
• 可出站访问 www.autoid.ro 的 HTTPS 连接

不需要访问 WordPress 数据库、WooCommerce API 密钥或 WordPress 管理员凭据。

全新安装

unzip autoid-mcp-v0.3.1.zip
cd autoid-mcp-v0.3.1
npm install
cp .env.example .env
npm run build
npm run smoke:api
npm start

环境变量：

AUTOID_API_BASE=https://www.autoid.ro/wp-json/autoid-ai/v1
MCP_PUBLIC_HOST=mcp.autoid.ro
PORT=3000
AUTOID_API_TIMEOUT_MS=15000

公共 MCP 端点：

https://mcp.autoid.ro/mcp

HTTP 进程健康状态：

https://mcp.autoid.ro/health

规范 API 就绪状态检查：

https://mcp.autoid.ro/ready

使用 systemd 从 v0.1.0 升级

假设线上应用目录为 /opt/autoid-mcp：

sudo systemctl stop autoid-mcp
sudo cp -a /opt/autoid-mcp /opt/autoid-mcp-backup-v0.1.0
sudo rm -rf /opt/autoid-mcp
sudo mkdir -p /opt/autoid-mcp
sudo cp -a ./autoid-mcp-v0.3.1/. /opt/autoid-mcp/
sudo cp /opt/autoid-mcp-backup-v0.1.0/.env /opt/autoid-mcp/.env
cd /opt/autoid-mcp
sudo npm install
sudo npm run smoke:api
sudo npm run build
sudo chown -R www-data:www-data /opt/autoid-mcp
sudo cp deploy/autoid-mcp.service /etc/systemd/system/autoid-mcp.service
sudo systemctl daemon-reload
sudo systemctl enable autoid-mcp
sudo systemctl restart autoid-mcp
sudo systemctl status autoid-mcp

然后验证：

curl -s https://mcp.autoid.ro/health
curl -s https://mcp.autoid.ro/ready

Docker

随附的 Dockerfile 特意使用 npm install，因为此版本发布包不包含生成的锁定文件。

docker compose -f deploy/docker-compose.yml up -d --build

容器仅绑定到 127.0.0.1:3000；请通过随附的 Nginx 反向代理配置对外提供服务。

首次 MCP 验证

部署后，在 MCP 客户端中验证以下工具调用：

autoid_api_health({})
get_product_group({ model: "MC9300" })
list_product_variants({ model: "MC9300", availability: "available", limit: 20 })
get_product_offer({ sku: "MC930B-GSHDG4RW" })
get_related_products({ target: "MC9300", relation_type: "accessory", availability: "available", limit: 20 })
get_related_products({ target: "ZT610", relation_type: "consumable", category: "ribboane-imprimanta", availability: "available", limit: 20 })
get_related_products_summary({ target: "ZT610", relation_type: "consumable" })

HestiaCP 部署说明

如果主机由 HestiaCP 管理，且域名模板已将 mcp.autoid.ro 代理到端口 3000，请勿覆盖 Hestia Nginx 或 Certbot 配置。只需替换/构建应用文件，并通过主机管理员首选的进程管理器重启现有 Node 进程。

安全性

v0.3.1 为只读版本。它不会公开任何 WordPress 凭据，也不会执行任何写入操作。规范 API 仍是数据和安全边界。

在添加 RFQ 创建等写入工具之前，请另外添加身份验证、授权、审计日志和滥用控制。

公共根路径

在浏览器中打开 https://mcp.autoid.ro/，会返回一个简洁的用户首页，其中包含指向 /health、/ready 和 /mcp 的链接。Node 进程绑定到 127.0.0.1:3000，设计上仅通过现有 HestiaCP/Nginx 反向代理对外提供服务。

Support Center 工具 — v0.3.1

公共端点 https://mcp.autoid.ro/mcp 现在除了提供现有目录工具外，还提供三个 Support Center 工具：

• search_support — 搜索型号、手册、驱动程序、固件、软件、视频和故障排除资源。
• fetch_support — 获取搜索返回的某个确切 model:<id> 或 resource:<id>。
• autoid_support_health — 验证只读 Support Center 源。

Support 数据通过现有的一方 AutoID Support MCP 源（AUTOID_SUPPORT_MCP_URL，默认值为 https://www.autoid.ro/mcp/）进行代理。Node 服务不会读取 WordPress SQL、文件系统或管理 API。产品数据仍来自 AUTOID_API_BASE。

v0.3.1 中的 search_support 能根据意图进行搜索：它会合并原始查询、针对整个型号的搜索以及按所请求资源类型进行的搜索，对结果去重，并将所请求的类型排在通用资源之前。像 MC9300 firmware manual 这样的多意图查询，应在无关的通用资源之前同时显示固件/LifeGuard 条目和文档/手册条目。

对于聊天集成，推荐的 OpenAI Responses API 配置是一个指向 https://mcp.autoid.ro/mcp 的只读远程 MCP 工具，并设置明确的 allowed_tools 列表和 require_approval: never。有关当前价格/库存的问题应使用 get_product_offer；技术支持资源应先使用 search_support，再使用 fetch_support。