Skip to main content
Glama

Frisco MCP

一个 TypeScript 模型上下文协议 (MCP) 服务器,允许 AI 助手(Claude、Gemini 等)与 frisco.pl(波兰的在线杂货店)进行交互。

安全第一 — 该服务器绝不会存储您的电子邮件或密码。您可以在可见的浏览器窗口中手动登录;仅会话 cookie 会在本地持久化。

示例:AI 将购物清单中的产品添加到 Frisco 购物车


功能

会话

工具

描述

login

在登录页面打开一个可见的 Chromium 窗口。您手动登录;服务器会轮询登录成功状态并保存会话 cookie。

finish_session

在结账页面打开浏览器,以便您可以选择送货时段并付款。无自动付款功能。

clear_session

关闭浏览器并删除保存的会话文件。

购物车

工具

描述

add_items_to_cart

将产品添加到购物车。支持两种流程:(1) 通过 productUrl — 直接导航到产品页面并点击“Do koszyka”;(2) 从最新的 search_products 结果页面添加。

view_cart

返回当前购物车内容和总价。

remove_item_from_cart

按名称(部分匹配)从购物车中移除特定产品。

update_item_quantity

更改购物车中已有产品的数量(部分名称匹配)。

check_cart_issues

检测购物车中售罄或不可用的产品,并列出每种产品的可用替代品。

view_promotions

显示当前购物车中的活动促销、折扣和总节省金额。

产品

工具

描述

search_products

搜索 frisco.pl,返回前 N 个结果及其价格/可用性,并保存搜索 URL/上下文以供后续添加到购物车。

get_product_info

返回详细的产品信息:营养价值(每 100 克宏量营养素)、重量/克数、成分、价格(包括原价和促销时的单价)。

get_product_reviews

返回产品的客户评论和评分(来自 Trustmate)。

日志

工具

描述

get_logs

返回当前或特定会话的 JSONL 日志事件。

tail_logs

返回最近的 N 个日志事件。


Related MCP server: Rohlik MCP Server

架构

flowchart LR
    A[MCP Client / AI Assistant] -->|stdio| B[src/index.ts<br/>McpServer]

    B --> C[Session Tools<br/>src/tools/session.ts]
    B --> D[Cart Tools<br/>src/tools/cart.ts]
    B --> E[Product Tools<br/>src/tools/products.ts]

    C --> G[src/browser.ts<br/>Playwright singleton]
    D --> G
    E --> G

    C --> H[src/auth.ts<br/>session cookies]
    D --> H
    E --> H

    D --> I[src/tools/helpers.ts<br/>navigation, HTML parsing & formatters]
    E --> I

    H --> J[(~/.frisco-mcp/session.json)]
    B --> L[src/logger.ts] --> M[(~/.frisco-mcp/logs/)]
    G --> N[(in-memory lastSearchContext)]
    G --> K[frisco.pl 🌐]
    I --> K

更多图表(登录流程、购物车流程):docs/DIAGRAMS.md


要求

  • Node.js 20 或更高版本

  • Chromium(用于 Playwright,通过下方的安装命令安装)


设置

npm install
npx playwright install chromium
npm run build

MCP 客户端配置

服务器通过 stdio 进行通信 — 将您的 MCP 客户端指向 node dist/index.js。

Claude Desktop

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "frisco": {
      "command": "node",
      "args": ["/absolute/path/to/frisco-mcp/dist/index.js"]
    }
  }
}

Gemini (Google AI Studio)

此仓库中的 .gemini/settings.json 已经包含了配置:

{
  "mcpServers": {
    "frisco-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/frisco-mcp/dist/index.js"]
    }
  }
}

Cursor

添加到您的 Cursor MCP 设置中(~/.cursor/mcp.json 或工作区 .cursor/mcp.json):

{
  "mcpServers": {
    "frisco": {
      "command": "node",
      "args": ["/absolute/path/to/frisco-mcp/dist/index.js"]
    }
  }
}

注意: 将路径替换为您机器上 dist/index.js 的绝对路径。


使用方法

1. 登录

“帮我登录 Frisco”

login 工具会在 frisco.pl/login 打开一个 Chromium 窗口。手动登录 — 服务器最多等待 5 分钟,并在检测到成功登录后保存您的会话 cookie。

2. 购物

“帮我找天然酸奶”

search_products 工具返回匹配的产品列表及其价格。不可用的产品会标记为 ⚠️ NIEDOSTĘPNY。它还会保存当前的搜索 URL 和结果上下文,以供后续购物车操作使用。

“告诉我更多关于 PIĄTNICA Skyr 的信息”

get_product_info 工具导航到产品页面并提取详细信息:营养价值(每 100 克的千卡、蛋白质、脂肪、碳水化合物、糖、盐)、重量/克数、成分、价格(包括原价和促销产品的单价)以及产品 URL。

“把它加到购物车”

add_items_to_cart 工具支持两种流程:(1) 如果提供了 productUrl(例如来自 get_product_info),它会直接导航到该产品页面并点击“Do koszyka” — 这是首选流程;(2) 否则,它会使用最新的 search_products 结果页面来查找并添加产品。

“把黄油从我的购物车里移除”

remove_item_from_cart 工具通过名称在购物车中查找产品并将其移除。

“把牛奶数量改为 3”

update_item_quantity 工具在购物车中查找产品并更新其数量。

“我的购物车有什么问题吗?”

check_cart_issues 工具扫描购物车中的售罄产品,并为每种产品显示可用的替代品。

“Skyr Piątnica 有什么评价?”

get_product_reviews 工具从 Trustmate 获取客户评分和评论。

“显示我购物车里的活动促销”

view_promotions 工具列出所有活动促销、折扣徽章和总节省金额。

3. 结账

“结束我的 Frisco 会话”

finish_session 工具在 frisco.pl/stn,cart 打开您的购物车,以便您可以选择送货时段并付款 — 服务器绝不会自动执行付款。


项目结构

frisco-mcp/
├── src/
│   ├── index.ts          # MCP server setup, tool registration
│   ├── auth.ts           # Session cookie save/restore, login check
│   ├── browser.ts        # Playwright browser singleton, product cache, last search context
│   ├── logger.ts         # JSONL session logging
│   ├── types.ts          # Shared TypeScript types
│   └── tools/
│       ├── session.ts    # login, finish_session, clear_session
│       ├── cart.ts       # add_items_to_cart, view_cart, remove_item_from_cart,
│       │                 #   update_item_quantity, check_cart_issues, view_promotions
│       ├── products.ts   # search_products, get_product_info, get_product_reviews
│       └── helpers.ts    # Navigation, popup dismissal, DOM parsing, formatters
│   └── __tests__/        # Unit tests (Vitest)
├── test_data/            # Sample HTML fixtures for tests
│   └── products/         #   Product page HTMLs (skyr, chicken, bananas, eggs, bag, promotion)
├── docs/
│   └── DIAGRAMS.md       # Mermaid architecture & flow diagrams
├── .github/
│   └── workflows/
│       └── test.yml      # CI — runs tests on push & PR
├── dist/                 # Compiled JS (generated by `npm run build`)
├── vitest.config.ts
├── package.json
├── tsconfig.json
└── .gitignore

数据存储

所有用户数据都存储在本地的 ~/.frisco-mcp/ 中:

文件

用途

session.json

保存的浏览器 cookie(无凭据)

current-session.json

指向活动日志会话的指针

logs/<id>.jsonl

每个会话的事件日志


开发

# Run in dev mode (tsx, no separate build step)
npm run dev

# Build
npm run build

# Run built server
npm start

# Run tests
npm test

# Watch mode for tests
npm run test:watch

CI

测试通过 GitHub Actions (.github/workflows/test.yml) 在每次 push 和 pull request 到 master 时自动运行。矩阵测试针对 Node.js 20 和 22。


技术栈

库

角色

@modelcontextprotocol/sdk

MCP 服务器框架

playwright

浏览器自动化 (Chromium)

cheerio

用于产品信息的 HTML 解析

zod

输入模式验证

typescript

语言与构建

vitest

单元测试框架


许可证

本项目采用 MIT 许可证 授权。

Available Tools

10 tools
add_items_to_cartA

Searches for and adds a list of products to the cart. By default appends to current cart, optionally clearing it first.

Inputs: items (required), clearCartFirst.

clear_sessionB

Clears the saved session and closes the browser.

Inputs: no named parameters.

finish_sessionA

Opens the browser at the checkout page so you can select a delivery time and pay.

Inputs: no named parameters.

get_logsB

Returns persisted JSONL log events for the current or selected session.

Inputs: sessionId, limit.

get_product_infoA

Gets detailed info for a product: nutritional values (macros per 100g), weight/grammage, ingredients, and price.

Inputs: query (required).

loginA

Opens a visible Chromium browser to log in to Frisco manually. Run this first to establish a session.

Inputs: no named parameters.

remove_item_from_cartA

Removes a specific product from the Frisco cart by name (partial match supported).

Inputs: productName (required).

search_productsA

Searches frisco.pl for products and returns top matches with prices.

Inputs: query (required), topN.

tail_logsB

Returns the most recent events from persisted session logs.

Inputs: sessionId, lines.

view_cartA

Returns the current contents and total of the Frisco cart.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools are clearly distinct: search_products vs get_product_info, add_items_to_cart vs view_cart vs remove_item_from_cart. The only real overlap is get_logs vs tail_logs, both returning persisted log events, though the descriptions (all events vs most recent) provide some separation.

    Naming Consistency5/5

    Tool names consistently follow a verb_noun snake_case pattern: get_logs, tail_logs, finish_session, clear_session, add_items_to_cart, search_products, get_product_info, remove_item_from_cart, view_cart. Even 'login' fits the simple verb style without breaking the pattern.

    Tool Count5/5

    10 tools is well-scoped for an online grocery automation server. Each tool maps to a clear workflow stage: session management, product discovery, cart manipulation, and checkout handoff. No redundant or superfluous tools.

    Completeness4/5

    The core shopping lifecycle is covered: login, search products, inspect product details, add/remove/view cart, and finish session for checkout. Minor gaps exist, such as no explicit quantity adjustment or standalone clear-cart tool, but add_items_to_cart's optional clearing and the manual checkout flow mitigate most dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to search grocery products, build and manage shopping carts, and access account, order, delivery, and discount information through the Rohlik Group's online grocery delivery platforms. Supports multiple country-specific storefronts by selecting a regional base URL.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to shop groceries across Rohlik Group platforms by searching products, managing carts, analyzing purchase history for personalized suggestions, and accessing account, order, delivery, and discount information.
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to search grocery products, manage shopping carts, and access account, order, delivery, and discount information across multiple European online grocery platforms.
      MIT