🚀 Rami Levy MCP 服务器
Rami Levy MCP 服务器是用于 Rami Levy 在线杂货店 API 的服务器。该实现主要演示了如何将 Rami Levy 的电子商务平台与支持 MCP 的大语言模型（LLM）进行集成。
🚀 快速开始
若要使用 Rami Levy MCP 服务器，需完成以下设置步骤：
认证
此 MCP 服务器需要来自活动 Rami Levy 会话的身份验证令牌。要获取这些：
- 登录到 Rami Levy 网站
- 打开浏览器的开发者工具（F12）
- 转到网络标签
- 发出任何请求（例如，搜索产品）
- 从请求头中提取：
RAMI_LEVY_API_KEY：授权标头中 "Bearer" 之后的令牌ECOM_TOKEN：完整的 ecomtoken 标头值COOKIE：完整的 cookie 标头值
环境变量
创建一个 .env 文件，包含以下变量：
RAMI_LEVY_API_KEY=your_api_key_here
ECOM_TOKEN=your_ecom_token_here
COOKIE=your_cookie_string_here
与 Claude Desktop 使用
将以下内容添加到 claude_desktop_config.json：
{
"mcpServers": {
"rami-levy": {
"command": "npx",
"args": [
"rami-levy"
]
}
}
}
✨ 主要特性
工具
-
search_items- 功能：搜索目录中的产品
- 输入：
q(字符串)：搜索查询store(字符串，可选)：商店标识符（默认："331"）aggs(数字，可选)：聚合标志（默认：1）
- 返回：包含名称、价格、图片 URL 和 ID 的产品数组
-
add_to_cart- 功能：添加一个或多个商品到购物车
- 输入：
store(字符串)：商店标识符（例如："331"）items(数组)：要添加的商品列表，每个包含：id(数字)：产品标识符quantity(数字)：添加的数量（最小值：1）
- 返回：更新后的购物车内容，包括价格和折扣
-
remove_from_cart- 功能：通过提供要保留的商品列表从购物车中移除商品
- 输入：
store(字符串)：商店标识符items(数组)：购物车中要保留的商品更新列表
- 返回：更新后的购物车内容
-
update_quantity- 功能：更新购物车中商品的数量
- 输入：
store(字符串)：商店标识符id(数字)：产品标识符newQuantity(数字)：产品的最新数量（最小值：1）
- 返回：更新后的购物车内容
资源
rami-levy://checkout- 功能：获取 Rami Levy 结算页面的 URL
- 返回：结算页面 URL
📦 安装指南
安装依赖项
使用以下命令安装所需的包：
npm install express cors
运行服务器
运行 index.js 脚本以启动 MCP 服务器。
💻 使用示例
本项目提供了一系列工具和资源，以下为你展示部分工具的使用示例：
基础用法
// 搜索产品示例
const searchParams = {
q: 'apple',
store: '331',
aggs: 1
};
// 调用 search_items 工具进行产品搜索
// 这里假设已经有调用 search_items 的函数，实际使用时需要根据项目实现
search_items(searchParams).then(result => {
console.log(result);
});
// 添加商品到购物车示例
const cartItems = [
{
id: 123,
quantity: 2
}
];
const cartParams = {
store: '331',
items: cartItems
};
// 调用 add_to_cart 工具将商品添加到购物车
// 这里假设已经有调用 add_to_cart 的函数，实际使用时需要根据项目实现
add_to_cart(cartParams).then(result => {
console.log(result);
});
🔧 技术细节
安全考虑
- 确保敏感信息（如 API 密钥和令牌）不暴露在客户端。
- 定期更新依赖项以防止已知的安全漏洞。
限制
- 当前版本仅支持有限的 API 功能。
- 可能存在性能瓶颈，特别是在高流量情况下。
🤝 贡献
要为项目做出贡献，请遵循以下步骤：
- 创建功能分支。
- 提交您的更改。
- 开启拉取请求进行审查。
📄 许可证
[在此处添加许可证信息]
此文档提供了 Rami Levy MCP 服务器的全面概述，包括工具、设置和开发指南。如需进一步帮助，请参考相关资源或联系支持团队。