Rohlik MCP Server

社区

让您的AI助手在Rohlik集团平台上购买杂货。

分类: 其他第 168 / 230
Stars: ★ 121 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 个月前 ⚠
工具数: 18

47FMRS · D

Rohlik MCP服务器提供了一套全面的工具，用于通过AI助手在多个欧洲平台上进行杂货购物。它强调了AI驱动购物的便利性，但由于依赖反向工程API和涉及真实购买和凭据的风险，仅供个人使用。安装简单，为Claude Desktop提供了清晰的配置，并包含了调试和验证工具。

最强项 · 文档质量 13/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

6/20

维护活跃度

12/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 服务器是一个真实的 TypeScript 项目，具有构建和测试脚本，但未提供任何 CI 工作流，且无法从仓库中直接验证关键行为（如 MCP 握手、工具注册或 API 调用的正确性）。测试只覆盖辅助转换逻辑，并未涉及服务器核心路径。错误处理虽有文档记录，但主要运行依赖外部的 Rohlik API，且该 API 为逆向工程，其稳定性与可控性有限。因此可靠性得分较低。
安全与权限 6/20: 服务器需要明文用户名和密码，并存储为环境变量，这属于较常见做法，但密码暴露面较大。它通过 HTTP 与 Rohlik API 通信，未明确说明 TLS 强制或证书验证。没有提供操作确认机制，例如将商品加入购物车或获取订单历史等操作可能意外执行。由于服务器仅提供购物车操作，没有删除或支付功能，因此风险相对可控。但未发现明确的凭据保护指南（如密钥管理），且逆向工程 API 可能带有隐含风险。
维护活跃度 12/20: 仓库近期有提交，且有 117 个星标，4 个未关闭问题，表明项目正在维护。MIT 许可证存在，且有版本发布和 NPM 发布流程。但未提供明确的安全响应渠道（如 SECURITY.md）或依赖更新策略。依赖管理不透明，且逆向工程 API 可能带来维护挑战。
文档质量 13/20: README 非常详细：涵盖安装、配置、工具说明、故障排除、调试和 API 验证使用方法。包含多个平台示例，并有智能购物工具的说明和文档指南。但缺少完整的工具参数列表，以及每个工具可能对用户账户造成的副作用说明。故障排除部分虽全面，但依赖外部 API 的稳定性，且未披露汇率或成本等限制。
安装易用性 11/20: 安装步骤清晰：需要 Node.js 和 npm，通过 npx 或本地构建。提供了 Claude Desktop 的配置示例，支持 Windows 和 macOS 路径。但可能需要额外步骤，如设置环境变量和确保 Node 版本兼容。由于需要真实账户凭据才能运行，这增加了使用门槛。没有提供 Docker 或其他简化部署方式。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

希望使用AI助手在Rohlik集团平台（捷克、德国、奥地利、匈牙利、罗马尼亚）购买日常杂货的用户。
希望自动化购物清单管理或获得个性化食品建议的用户。
个人使用，并接受非官方API的学术或研究目的。

不适合谁

商业用途或大规模自动化。
需要官方支持或稳定性的生产环境。
没有Rohlik账户或无法提供凭据的用户。
不支持的国家（意大利、西班牙目前计划中）。

所需权限

需要您的Rohlik用户名和密码才能登录。
可以访问您的账户信息，包括订单历史、配送详情和购物车。
可以修改您的购物车（添加/移除商品）。
可能会代表您下单（如果LLM被指示这样做）。

风险与副作用

使用反向工程API违反了服务条款，可能导致账户被封禁。
凭据以明文存储在配置文件中的风险。
AI助手可能错误地添加或移除商品，导致意外购买或取消。
依赖非官方API，可能随时更改或中断。

安装接入

准备工作

运行环境：Node.js

ROHLIK_USERNAME 必填 Rohlik（或对应区域站点）账号的登录邮箱，注册时获得。

ROHLIK_PASSWORD 必填密钥 Rohlik 账号密码，在客户端配置中自行填写。

其他可选配置项（2 个）

ROHLIK_BASE_URL 可选区域站点地址（如 https://www.rohlik.cz、https://www.knuspr.de），不设默认捷克站。

ROHLIK_DEBUG 可选设为 true 开启详细调试日志，用于排查认证问题。

确保已安装Node.js和npm。
在Claude Desktop配置文件中添加MCP服务器配置（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %APPDATA%/Claude/claude_desktop_config.json），填入您的Rohlik凭据和所需的ROHLIK_BASE_URL（例如https://www.rohlik.cz）。
重启Claude Desktop。

claude_desktop_config.json

{
  "mcpServers": {
    "rohlik": {
      "command": "npx",
      "args": [
        "-y",
        "@tomaspavlin/rohlik-mcp"
      ],
      "env": {
        "ROHLIK_USERNAME": "[email protected]",
        "ROHLIK_PASSWORD": "your-password",
        "ROHLIK_BASE_URL": "https://www.rohlik.cz"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "rohlik": {
      "command": "npx",
      "args": [
        "-y",
        "@tomaspavlin/rohlik-mcp"
      ],
      "env": {
        "ROHLIK_USERNAME": "[email protected]",
        "ROHLIK_PASSWORD": "your-password",
        "ROHLIK_BASE_URL": "https://www.rohlik.cz"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add rohlik -e [email protected] -e ROHLIK_PASSWORD=your-password -e ROHLIK_BASE_URL=https://www.rohlik.cz -- npx -y @tomaspavlin/rohlik-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置后在 Claude Desktop 工具列表中应出现 rohlik 服务器的 search_products 等工具；询问“我的购物车里有什么？”若返回 get_cart_content 的结果即连接成功。

常见排障

登录失败：检查凭据、启用调试模式（ROHLIK_DEBUG=true）、运行npm run validate-api。
找不到订单历史：确保账户至少有一个已完成订单。
响应缓慢：减少智能购物功能分析的订单数量。
产品未找到：使用部分名称搜索，或直接在网站上验证产品。
spawn npx ENOENT：使用npx的绝对路径或直接使用node命令。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把做苹果派的食材加入购物车，只要无麸质且经济实惠的。
我这周通常买的午餐有哪些推荐？
本周有什么打折商品？
明早最便宜的配送时段是哪些？

工具能力 18

search_products 只读

按名称搜索杂货产品，并带有筛选选项。

add_to_cart 写入

将多个产品添加到您的购物车。

get_cart_content 只读

查看当前购物车内容和总计。

remove_from_cart 写入

从购物车中移除商品。

get_shopping_list 只读

通过ID获取购物清单。

get_meal_suggestions 只读

根据您的历史订单获取个性化建议（早餐、午餐、晚餐、零食、烘焙、饮品或健康饮食）。

get_frequent_items 只读

分析订单历史，找出最常购买的商品（总体及分类）。

get_shopping_scenarios 只读

交互式指南，展示MCP的功能。

展开其余 10 个工具

get_discounted_items 只读

浏览当前折扣商品，可按食品类别筛选、排序和分页。

get_account_data 只读

获取包括配送详情、订单、公告、购物车和高级状态在内的综合账户信息。

get_order_history 只读

查看过去已配送的订单详情。

get_order_detail 只读

获取特定订单的详细信息，包括所有产品。

get_upcoming_orders 只读

查看已安排的即将到来的订单。

get_delivery_info 只读

获取当前配送信息和费用。

get_delivery_slots 只读

查看您地址可用的配送时间段。

get_premium_info 只读

检查您的Rohlik Premium订阅状态和权益。

get_announcements 只读

查看当前公告和通知。

get_reusable_bags_info 只读

跟踪您的可重复使用袋子和环境影响。

使用场景

常规购物：让LLM根据食谱或购物清单添加食材。

智能购物：根据历史订单获取个性化建议和常购商品。

优惠与折扣：探索当前折扣商品。

计划：检查配送时间段、即将到来的订单和订单历史。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Rohlik MCP服务器是一个Model Context Protocol实现，使AI助手能够与Rohlik集团旗下多个国家的在线杂货配送服务交互。该服务器提供搜索产品、管理购物车和访问账户信息的工具。支持Rohlik.cz（捷克）、Knuspr.de（德国）、Gurkerl.at（奥地利）、Kifli.hu（匈牙利）和Sezamo.ro（罗马尼亚）。仅供个人使用，基于反向工程API。