Skip to main content
Glama

Frisco MCP

TypeScript-сервер Model Context Protocol (MCP), который позволяет ИИ-ассистентам (Claude, Gemini и др.) взаимодействовать с frisco.pl — польским онлайн-супермаркетом.

Безопасность прежде всего — сервер никогда не сохраняет ваш email или пароль. Вы входите в систему вручную в видимом окне браузера; локально сохраняются только сессионные файлы cookie.

Пример: ИИ добавляет товары из списка покупок в корзину 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

Добавьте в настройки MCP вашего Cursor (~/.cursor/mcp.json или .cursor/mcp.json в рабочей области):

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

Примечание: Замените путь на абсолютный путь к dist/index.js на вашем компьютере.


Использование

1. Вход в систему

"Log me in to Frisco"

Инструмент login открывает окно Chromium на странице frisco.pl/login. Войдите вручную — сервер подождет до 5 минут и сохранит ваши сессионные cookie, как только обнаружит успешный вход.

2. Покупки

"Find me natural yogurt"

Инструмент search_products возвращает список подходящих товаров с ценами. Недоступные товары помечены как ⚠️ NIEDOSTĘPNY. Он также сохраняет текущий URL поиска и контекст результатов для последующих операций с корзиной.

"Tell me more about the PIĄTNICA Skyr"

Инструмент get_product_info переходит на страницу товара и извлекает подробную информацию: пищевую ценность (ккал, белки, жиры, углеводы, сахара, соль на 100 г), вес/граммовку, состав, цену (включая исходную цену и цену за единицу для акционных товаров) и URL товара.

"Add it to cart"

Инструмент add_items_to_cart поддерживает два сценария: (1) если предоставлен productUrl (например, из get_product_info), он переходит напрямую на страницу товара и нажимает «Do koszyka» — это предпочтительный сценарий; (2) в противном случае он использует последнюю страницу результатов search_products для поиска и добавления товара.

"Remove the butter from my cart"

Инструмент remove_item_from_cart находит товар в корзине по названию и удаляет его.

"Change the milk quantity to 3"

Инструмент update_item_quantity находит товар в корзине и обновляет его количество.

"Are there any issues with my cart?"

Инструмент check_cart_issues сканирует корзину на наличие распроданных товаров и показывает доступные замены для каждого из них.

"What reviews does Skyr Piątnica have?"

Инструмент get_product_reviews получает оценки и отзывы покупателей от Trustmate.

"Show me active promotions in my cart"

Инструмент view_promotions перечисляет все активные акции, значки скидок и общую экономию.

3. Оформление заказа

"Finish my Frisco session"

Инструмент 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

Тесты запускаются автоматически при каждом push и pull request в ветку master через GitHub Actions (.github/workflows/test.yml). Матрица тестирует работу с 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