Ecommerce MCP CLI

MCP (Model Context Protocol) CLI 工具，用于将 Ecommerce Generator 服务连接到 Claude Desktop 等 AI 客户端。

安装

全局安装（推荐）

npm install -g ecommerce-mcp-cli
# 或
pnpm add -g ecommerce-mcp-cli
# 或
yarn global add ecommerce-mcp-cli

使用 npx（无需安装）

npx ecommerce-mcp-cli

使用方法

1. 获取 MCP Token

在 Ecommerce Generator 网站的"MCP Token"页面创建一个 Token。

2. 设置环境变量

export MCP_TOKEN=your-token-here
export API_URL=http://localhost:3000  # 可选，默认为 http://localhost:3000

3. 启动服务

ecommerce-mcp

4. 配置 Claude Desktop

在 Claude Desktop 配置文件中添加：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ecommerce-generator": {
      "command": "ecommerce-mcp",
      "env": {
        "MCP_TOKEN": "your-token-here",
        "API_URL": "http://localhost:3000"
      }
    }
  }
}

5. 重启 Claude Desktop

配置完成后，重启 Claude Desktop 即可使用 MCP 服务。

环境变量

| 变量名 | 必需 | 默认值 | 说明 | |--------|------|--------|------| | MCP_TOKEN | 是 | - | MCP 认证 Token（从网站获取） | | API_URL | 否 | http://localhost:3000 | Ecommerce Generator API 地址 | | DEBUG | 否 | - | 启用调试日志 |

MCP Tools

当前支持的 MCP Tools：

| Tool 名称 | 描述 | 参数 | |-----------|------|------| | get_user_credits | 获取用户积分余额 | 无 | | get_user_products | 获取用户产品列表 | limit (可选，默认 10) | | get_user_tasks | 获取用户任务列表 | status (可选), limit (可选，默认 10) |

开发

构建

npm run build
# 或
pnpm build

本地测试

# 开发模式（监听文件变化）
npm run dev

# 直接运行
MCP_TOKEN=test-token node dist/cli.js

发布到 npm

# 1. 更新版本号
npm version patch  # 或 minor, major

# 2. 构建
npm run build

# 3. 发布
npm publish

故障排查

Token 无效

• 检查 MCP_TOKEN 环境变量是否正确设置
• 确认 Token 未被撤销或过期

连接失败

• 检查 API_URL 是否指向正确的服务地址
• 确认 Ecommerce Generator 服务正在运行

Tools 不工作

• 确认用户有足够的权限访问相关数据
• 启用调试日志：DEBUG=1 ecommerce-mcp

许可证

MIT