使用说明

项目简介

本项目是一个用于Rami Levy在线杂货店的概念验证MCP服务器。它允许LLM(大型语言模型)通过标准化的MCP协议与Rami Levy电商平台进行交互,实现商品搜索、管理购物车以及获取结账链接等功能。

主要功能点

  • 商品搜索: 使用 'search_items' 工具在Rami Levy商品目录中搜索商品。
  • 购物车管理: 使用 'add_to_cart', 'remove_from_cart', 和 'update_quantity' 工具管理购物车中的商品。
  • 获取结账链接: 通过访问 'rami-levy://checkout' 资源获取Rami Levy结账页面URL。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/shilomagen/rami-levy-mcp.git
  2. 进入项目目录:
    cd rami-levy-mcp
  3. 安装依赖:
    npm install
  4. 构建项目:
    npm run build
  5. 创建 '.env' 文件: 在项目根目录下创建 '.env' 文件,并根据 README.md 中的 "Setup" 部分的指引,配置 Rami Levy API 的认证信息('RAMI_LEVY_API_KEY', 'ECOM_TOKEN', 'COOKIE')。

服务器配置 (MCP 客户端配置)

以下是将此 MCP 服务器添加到 MCP 客户端(例如 Claude Desktop)的配置示例。您需要将此配置添加到您的 MCP 客户端的配置文件中。

{
  "mcpServers": {
    "rami-levy": {
      "command": "npm",
      "args": [
        "start"
      ],
      "env": {
        // 环境变量在此处留空,因为服务器会从 .env 文件中读取配置。
        // 如果您需要为 MCP 客户端指定特定的环境变量,可以在此处添加。
      }
    }
  }
}

配置参数说明:

  • 'server name': 'rami-levy' (服务器名称,可以自定义)
  • 'command': 'npm' (启动服务器的命令,这里使用 npm)
  • 'args': '["start"]' (传递给 'npm' 命令的参数,'start' 是 package.json 中定义的启动脚本)
  • 'env': '{}' (环境变量配置,此处留空表示服务器将从 '.env' 文件读取)

基本使用方法

  1. 启动服务器: 在项目根目录下运行命令启动 MCP 服务器:
    npm start
  2. 配置 MCP 客户端: 将上述服务器配置添加到您的 MCP 客户端配置文件中。
  3. 在 LLM 中使用工具和资源: 在您的 LLM 应用中,您现在可以通过 MCP 客户端调用 'search_items', 'add_to_cart' 等工具,并访问 'rami-levy://checkout' 资源,与 Rami Levy 在线商店进行交互。

信息

分类

商业系统