Rami Levy MCP Server

基本能力

产品定位

Rami Levy MCP Server 是一个用于与 Rami Levy 在线杂货店 API 集成的概念验证实现。

核心功能

1. 搜索商品：在 Rami Levy 的商品目录中搜索商品。
2. 添加到购物车：将一个或多个商品添加到购物车。
3. 从购物车移除商品：通过提供一个更新的商品列表来移除购物车中的商品。
4. 更新商品数量：更新购物车中商品的数量。
5. 获取结账页面 URL：获取 Rami Levy 结账页面的 URL。

适用场景

1. 与 Rami Levy 在线杂货店 API 集成。
2. 在支持 MCP 的 LLMs 中使用 Rami Levy 的电子商务功能。

工具列表

1. search_items：搜索 Rami Levy 商品目录中的商品。
2. add_to_cart：将一个或多个商品添加到购物车。
3. remove_from_cart：从购物车中移除商品。
4. update_quantity：更新购物车中商品的数量。
5. rami-levy://checkout：获取 Rami Levy 结账页面的 URL。

常见问题解答

1. 认证问题：需要从活动的 Rami Levy 会话中获取认证令牌。
2. 令牌过期：会话令牌会过期，需要手动刷新。
3. 安全考虑：认证令牌提供对 Rami Levy 账户的完全访问权限，应保持安全并不应提交到版本控制。
4. 功能限制：未实现 Rami Levy API 的某些功能（如用户配置文件、订单历史记录）。

使用教程

使用依赖

1. 安装 Node.js 和 npm。

安装教程

1. 安装依赖：

npm install

1. 构建项目：

npm run build

1. 启动服务器：

npm start

调试方式

1. 确保已正确设置环境变量（.env 文件）。
2. 使用 npm start 启动服务器后，可以通过 API 调用测试功能。

认证设置

1. 登录到 Rami Levy 网站。
2. 打开浏览器的开发者工具（F12）。
3. 转到网络选项卡。
4. 发出任何请求（例如搜索商品）。
5. 从请求头中提取：
6. RAMI_LEVY_API_KEY：Authorization 头中的 "Bearer" 后的令牌。
7. ECOM_TOKEN：完整的 ecomtoken 头值。
8. COOKIE：完整的 cookie 头值。

环境变量

创建 .env 文件并设置以下变量：

RAMI_LEVY_API_KEY=your_api_key_here
ECOM_TOKEN=your_ecom_token_here
COOKIE=your_cookie_string_here

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。