Continente MCP

Continente MCP

一个 MCP 服务，让 AI 助手可以在 Continente.pt 购物：搜索商品、查看价格和促销规则、 查看收藏和过往订单，以及将商品加入购物车。结账和付款始终在网站上进行。

非官方项目。 本项目与 Continente 或 MC Sonae 无关，也未获其认可或支持。 它通过无头浏览器自动操作公开网站，可能会因网站改动而失效，使用时应遵守网站条款。 对购物车中的任何商品，您都负有责任。

功能

• 目录搜索和商品详情，提供准确价格、单位价格、库存情况，以及称重商品和散装商品的 促销规则。
• 安全修改购物车。 每次修改后都会读取购物车进行确认。如果无法确认修改， 结果会明确说明，并提示助手检查购物车，而不是重试。
• 您的账户：收藏、订单历史记录，以及您购买最多的商品排名。
• 通过 stdio 在本地运行。您的凭据和会话存储在您的计算机上，且只会发送给 Continente.pt。
• 内置指南。 服务连接后会立即告知助手购物车规则，并提供包含完整购物流程的 basket-planner 提示词。无需安装其他内容；同一份指南也以 skill 的形式提供。

要求

• 使用账户功能需要 Continente.pt 账户（搜索和商品详情无需账户）
• 一键安装需要 macOS 或 Windows 上的 Claude Desktop；其他 MCP 客户端需要 Node.js 22 或更高版本

服务通过 Chromium 操作网站，并会在首次需要时自动下载 Chromium（约 150 MB，仅需下载一次）。

在 Claude Desktop 中安装（一键安装）

1. 从最新版本中下载 continente-mcp.mcpb。
2. 打开该文件。Claude Desktop 会显示安装对话框；点击 Install。
3. 按提示输入您的 Continente 邮箱和密码。Claude Desktop 会将密码保存在安全的设置存储中。

就是这样。该服务也已列入 MCP Registry，名称为 io.github.andredelgado/continente-mcp，因此可浏览注册表的客户端能够找到它。如需使用 1Password， 而不是将密码存储在 Claude Desktop 中，请使用下方的手动设置方法。

更新

服务每天会检查一次 npm 是否有新版。有新版时，它会告知助手，以便 Claude 提醒您； get_session_status 也会显示更新信息。

• 扩展程序： 下载新版 continente-mcp.mcpb 并打开。Claude Desktop 会就地更新 扩展程序，并保留您的邮箱和密码。
• npx 设置： 使用 continentept-mcp@latest，客户端重启时即可获取新版本。
• 发布邮件： 在 GitHub 上选择 Watch → Custom → Releases。

手动设置（适用于任何 MCP 客户端）

1. 保存你的凭据到 ~/.continentept-mcp/credentials.env（其他选项请参阅 配置）：

mkdir -p ~/.continentept-mcp && chmod 700 ~/.continentept-mcp
printf '[email protected]\nCONTINENTE_PASSWORD=your-password\n' > ~/.continentept-mcp/credentials.env
chmod 600 ~/.continentept-mcp/credentials.env

使用 1Password？可以跳过该文件，改为通过 op run 传递机密引用；请参阅 使用 1Password。

也可以检查登录是否正常：

npx -y continentept-mcp login

2. 将服务添加到你的 MCP 客户端。

Claude Code：

claude mcp add continente -- npx -y continentept-mcp

Claude Desktop、Cursor 和其他客户端（claude_desktop_config.json、mcp.json 等）：

{
  "mcpServers": {
    "continente": {
      "command": "npx",
      "args": ["-y", "continentept-mcp"]
    }
  }
}

若要将凭据文件存放在其他位置，请添加 "env": { "CONTINENTE_CREDENTIALS_FILE": "/absolute/path/to/credentials.env" }。

Chromium 会在首次使用时自行下载。若要提前下载，请运行 npx -y continentept-mcp install-browser（在 Linux 上，添加 --with-deps 以安装所需的系统 库）。

然后向你的助手提出类似这样的请求：“将半脱脂牛奶和一打鸡蛋加入我的 Continente 购物车”，或 “我平时都买什么？帮我列一份本周的购物清单。”

工具

工具	功能
search_products	按相关度搜索商品目录，标记收藏商品，并提供用于查看更多结果的游标
get_product	查询单个商品的价格、包装规格、库存情况和促销规则
get_product_labels	获取标签上标注的配料、过敏原和营养信息
choose_products	让用户从商品中选择；客户端支持时会显示照片
list_favorites	列出你保存的收藏商品（refresh: true 会获取最新内容）
get_cart	查看购物车商品、数量、购物袋和总计
preview_cart_changes	预览一系列变更的内容和费用，不会修改购物车
add_cart_item	在购物车现有数量上增加指定数量
set_cart_item_quantity	将购物车中的商品数量设为指定值；设为 0 即移除
remove_cart_item	从购物车中移除一项商品
clear_cart	通过一次确认操作清空整个购物车
list_orders	查看近期订单及其中的商品
get_order	查看单个订单中的商品
list_frequently_bought_products	按订购频率对商品进行排序
get_session_status	查看本地登录、Cookie 和缓存状态（不访问网络）

输入、输出、错误代码和限制请参阅工具参考。

关于结果不确定的购物车变更

购物车变更可能会在请求到达网站后失败，例如发生超时。 此时，结果会包含 mutation.outcome: "unknown"，并要求客户端在执行其他操作前调用 get_cart。服务不会自行重试这类变更，客户端也不应重试：重复调用 add_cart_item 可能会导致商品被添加两次。

助手指南

客户端连接时，服务会发送简短说明，其中包含这些购物车规则，因此助手无需任何设置即可遵循。若要规划购物清单，请在客户端的提示词或附件菜单中选择 basket-planner，也可以附上 “适合两人的每周购物清单”之类的请求。

同一指南也可作为技能使用，位于 skills/basket-planner。支持技能的客户端（例如 Claude Desktop（设置 → 功能 → 技能）或 Claude Code（~/.claude/skills/）） 会在你提出食品杂货相关问题时自动应用该指南。

命令行

continentept-mcp                    Start the MCP server on stdio
continentept-mcp login              Sign in and save the session (--show-browser to watch)
continentept-mcp install-browser    Download Chromium now instead of on first use (extra arguments go to Playwright)
continentept-mcp --version

限制

• 每个服务进程仅支持一个账户。
• 搜索最多读取 5 页结果，订单列表最多读取 10 页，因此范围很广的查询或很长的历史记录会标记为不完整，而不会读取全部内容。
• 登录支持标准的电子邮件和密码流程。如果网站要求额外验证，请运行 continentept-mcp login --show-browser，并在浏览器窗口中完成验证。
• 不提供结账、付款、配送时段或编辑收藏的工具。

文档

• 工具参考
• 稳定性：1.0 版本之后哪些变更属于破坏性变更
• 配置
• 故障排除
• 贡献指南
• 安全政策
• 更新日志

许可证

MIT