@onloon-ai/mcp-server

盈店通 claw-skills 统一 MCP 服务（stdio）。适用于 Claude Desktop、Cursor、VS Code、WorkBuddy 及其他支持 MCP 的客户端。

环境要求

• Node.js ≥ 18（推荐 20+）
• 可访问 npm registry（安装本包）与官方 prod 技能清单（运行时拉取技能）
• 有效的盈店通 OpenAPI 密钥（YDT_API_TOKEN）

默认配置

将以下内容加入所用客户端的 MCP 配置（如 Claude Desktop 的 claude_desktop_config.json、Cursor / VS Code 的 MCP 设置等）。建议钉死版本号，避免意外拉到未验证版本。

{
  "mcpServers": {
    "盈店通": {
      "command": "npx",
      "args": [
        "-y",
        "@onloon-ai/[email protected]"
      ],
      "env": {
        "YDT_API_TOKEN": "您的盈店通API密钥"
      }
    }
  }
}

配置说明：

| 项 | 说明 | |----|------| | command / args | 通过 npx 启动本包；默认连接生产环境 | | YDT_API_TOKEN | 必须写在 env 中。MCP 模式下只认该环境变量，不会读取本机 openclaw.json 或 .env | | 版本钉死 | 使用 @0.1.6 等形式；升级本包时再改版本号 |

配置完成后，重启客户端或重连「盈店通」服务器，确认状态为 connected。

需要强制重新下载技能时，在 args 末尾追加 "--refresh"：

"args": [
  "-y",
  "@onloon-ai/[email protected]",
  "--refresh"
]

技能更新

已发布的远端变更：重启 MCP；仍异常时加 --refresh。

安全说明

• 请勿将 YDT_API_TOKEN 写入文档、聊天记录、代码仓库或可公开的配置副本。
• Token 仅通过 MCP 配置的 env 注入；不会回落本机其它凭据文件。

常见问题与处理

以下问题多见于通过 npx 启动或 Windows 环境；若默认配置不稳定，可采用文末「本地安装」备用方案。

| 现象 | 可能原因 | 处理建议 | |------|----------|----------| | -32000: Connection closed | 进程启动失败；Windows 下客户端以无 shell 方式 spawn npx（.cmd）导致 EINVAL | 改用「本地安装 + node 绝对路径」；勿将 command 写成裸 npx.cmd / .bat | | -32001: Request timed out | npx 每次解析 / 校验版本过慢，或误加了强制重装参数 | 去掉不必要的 --refresh；先手动 npm install 预热；改用本地安装直启 | | 401 / missing bearer token | Token 未传入子进程 | 确认 YDT_API_TOKEN 写在 MCP 配置的 env 中，并重启连接 | | npx / 安装网络超时 | 无法访问 npm registry | 换镜像安装，例如：npm install @onloon-ai/[email protected] --registry https://registry.npmmirror.com | | 技能仍是旧版 | MCP 未重启，或本地缓存未刷新 | 重启 MCP；仍旧则加 --refresh |

备用方案：本地安装后直启（推荐用于排障）

当 npx 启动慢、超时或在 Windows 上失败时，可一次性安装到固定目录，再用 node 直接执行入口文件。

mkdir -p ~/mcp/onloon && cd ~/mcp/onloon
npm install @onloon-ai/[email protected]

确认入口存在：

ls node_modules/@onloon-ai/mcp-server/bin/claw-skills-mcp.js

获取 Node 路径后配置（Windows 请使用 node.exe 的完整路径；args 中入口文件亦须为绝对路径）：

{
  "mcpServers": {
    "盈店通": {
      "command": "<node 可执行文件的绝对路径>",
      "args": [
        "<安装目录>/node_modules/@onloon-ai/mcp-server/bin/claw-skills-mcp.js"
      ],
      "env": {
        "YDT_API_TOKEN": "您的盈店通API密钥"
      }
    }
  }
}

升级本包时，在同一目录执行 npm install @onloon-ai/mcp-server@<新版本> 即可；入口路径未变则无需修改 MCP 配置。

License

专有软件。使用须遵守盈店通相关服务条款与 API 使用规范。