Plytix MCP

Plytix MCP服务器

A. 轻量级、无状态的模型上下文协议（MCP）服务器 它为AI助手提供了对Plytix PIM（产品信息管理）数据的实时访问。该服务器使人工智能工具（如Claude Desktop、Claude移动应用程序和其他MCP客户端）能够直接从Plytix API搜索、查找和检索产品信息。

注： 这是一个用于读写操作的无状态实时API工具。有关同步、缓存或ETL工作流，请参阅 补给线同步.

特性

• 47个MCP工具通过stdio，44个通过远程工作器
• 智能产品查找 具有自动标识符检测功能（SKU、MPN、GTIN、标签）
• 家庭与遗产追踪 具有overwriten_attributes支持
• 架构发现 用于属性和搜索筛选器
• 自动身份验证 使用令牌刷新
• 费率限制处理 指数回退
• 零持久性 --无状态，无需数据库
• 远程服务器支持 --部署到Cloudflare Workers以进行移动/web访问

安装

先决条件

• Node.js 18+ （推荐节点20+）
• Plytix个人信息管理账户 具有API访问权限

设置

1. 克隆并安装：

git clone https://github.com/Supplyline/plytix-mcp.git
cd plytix-mcp
npm install

1. 配置凭据：

cp .env.example .env
# Edit .env with your Plytix API credentials

1. 构建项目：

npm run build

用法

使用克劳德桌面

添加到您的Claude Desktop MCP配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "plytix": {
      "command": "node",
      "args": ["/path/to/plytix-mcp/dist/index.js"],
      "env": {
        "PLYTIX_API_KEY": "your_api_key_here",
        "PLYTIX_API_PASSWORD": "your_api_password_here"
      }
    }
  }
}

独立

npm start          # Production mode
npm run dev        # Development with hot reload

远程服务器（Cloudflare Workers）

部署为远程MCP服务器，以便从Claude移动应用程序、web客户端或共享团队访问。

快速部署

# Install dependencies (includes wrangler)
npm install

# Login to Cloudflare
wrangler login

# Deploy to Cloudflare Workers
npm run deploy

使用远程服务器

部署后，使用部署的URL和您的Plytix凭据从任何MCP客户端连接：

# With Claude Desktop (using mcp-remote)
npx mcp-remote https://plytix-mcp.your-subdomain.workers.dev/mcp \
  --header "X-Plytix-API-Key: YOUR_API_KEY" \
  --header "X-Plytix-API-Password: YOUR_API_PASSWORD"

远程工作者暴露了44个工具。它故意省略了三个仅限本地的标识符实用程序： identifier_detect, identifier_normalize，以及 match_score.

本地开发

npm run dev:worker         # Start local worker at localhost:8787
npm run test:worker        # Test the worker endpoints

有关详细的设置说明，请参阅 docs/remote-setup.md.

可用工具

产品工具

家庭工具

属性和筛选工具

资产工具

分类工具

变体工具

关系工具

标识符实用程序（仅限Stdio）

除了最后一节中的三个标识符实用程序外，远程工作器还公开了上述所有工具。

智能查询系统

这 products_lookup 该工具自动检测标识符类型并使用分阶段搜索策略：

检测优先级：

1. MongoDB对象ID（24个字符十六进制）→ id （置信度：1.0）
2. GTIN（8/12/13/14位数字）→ gtin （置信度：0.95）
3. 包含空格→ label （置信度：0.9）
4. 虚线字母数字→ mpn （置信度：0.8）
5. 带分隔符的字母数字→ sku （置信度：0.7）

搜索策略（按顺序）：

1. 直接ID查找（如果检测为ID）
2. 精确的字段匹配（SKU、GTIN、MPN、MNO）
3. 跨多个字段的文本搜索
4. 广泛的LIKE搜索（最后手段）

例子：

Input: "LMI-PD-123"
→ Detected as: sku (confidence: 0.7)
→ Tries: sku_eq, mpn fields, text_search, broad_like
→ Returns: best match with confidence score

继承跟踪

产品退货 overwritten_attributes 数组列出了哪些属性是显式设置的（不是从族继承的）。将其与以下内容一起使用：

• product_family_id --该产品所属的家族
• families_get --检索族级默认值
• 比较以确定继承值与覆盖值

配置

环境变量

发展

脚本

建筑

src/
  index.ts              # MCP server entry point (stdio transport)
  worker.ts             # Cloudflare Worker entry point (HTTP transport)
  client.ts             # Plytix API client with auth & rate limiting
  worker-client.ts      # Worker-compatible client (BYOK credentials)
  worker-lookup.ts      # Worker-compatible smart lookup
  types.ts              # TypeScript types
  lookup/
    identifier.ts       # Identifier type detection
    lookup.ts           # Smart lookup with staged search
  tools/
    products.ts         # Product tools (lookup, get, search, find, write ops)
    families.ts         # Family tools (list, get, create, attribute membership)
    attributes.ts       # Attribute metadata + filter discovery tools
    product-attributes.ts # Atomic product attribute write tools
    assets.ts           # Asset get/search/update + product asset link tools
    categories.ts       # Category search + product category link tools
    variants.ts         # Variant lifecycle tools
    relationships.ts    # Relationship discovery + product relationship write tools
  supplyline/           # Supplyline-specific customizations
wrangler.toml           # Cloudflare Workers configuration
docs/
  remote-setup.md       # Remote server setup guide

设计原则

此MCP服务器是故意的 无状态和轻量级:

• 无数据库 -所有查询都直接进入Plytix API
• 无同步/缓存层 --每次请求都有新的数据
• 没有背景工作 --仅限请求/响应
• 临时内存缓存 --短暂（60秒）请求重复数据删除，重新启动时清除

对于ETL、同步或持久缓存需求，请使用单独的工具，如 补给线同步.

许可证

MIT许可证——见 许可证 文件以获取详细信息。

支持

• 问题:
• Plytix API: Plytix文件
• MCP协议: 模型上下文协议