Frisco MCP
Frisco MCP
TypeScript-сервер Model Context Protocol (MCP), который позволяет ИИ-ассистентам (Claude, Gemini и др.) взаимодействовать с frisco.pl — польским онлайн-супермаркетом.
Безопасность прежде всего — сервер никогда не сохраняет ваш email или пароль. Вы входите в систему вручную в видимом окне браузера; локально сохраняются только сессионные файлы cookie.

Функции
Сессия
Инструмент | Описание |
| Открывает видимое окно Chromium на странице входа. Вы входите вручную; сервер отслеживает успех и сохраняет сессионные cookie. |
| Открывает браузер на странице оформления заказа, чтобы вы могли выбрать время доставки и оплатить. Автоматическая оплата отсутствует. |
| Закрывает браузер и удаляет сохраненный файл сессии. |
Корзина
Инструмент | Описание |
| Добавляет товары в корзину. Поддерживает два сценария: (1) через |
| Возвращает текущее содержимое корзины и общую стоимость. |
| Удаляет конкретный товар из корзины по названию (частичное совпадение). |
| Изменяет количество товара, уже находящегося в корзине (частичное совпадение названия). |
| Обнаруживает распроданные или недоступные товары в корзине и перечисляет доступные замены для каждого из них. |
| Показывает активные акции, скидки и общую экономию в текущей корзине. |
Товары
Инструмент | Описание |
| Ищет товары на frisco.pl, возвращает топ N результатов с ценами/наличием и сохраняет URL поиска/контекст для добавления в корзину. |
| Возвращает подробную информацию о товаре: пищевая ценность (макросы на 100 г), вес/граммовка, состав, цена (включая исходную цену и цену за единицу, если товар по акции). |
| Возвращает отзывы покупателей и оценки (от Trustmate) для товара. |
Логи
Инструмент | Описание |
| Возвращает события журнала в формате JSONL для текущей или указанной сессии. |
| Возвращает 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/:
Файл | Назначение |
| Сохраненные cookie браузера (без учетных данных) |
| Указатель на активную сессию логов |
| Журналы событий для каждой сессии |
Разработка
# 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:watchCI
Тесты запускаются автоматически при каждом push и pull request в ветку master через GitHub Actions (.github/workflows/test.yml). Матрица тестирует работу с Node.js 20 и 22.
Технологический стек
Библиотека | Роль |
Фреймворк MCP-сервера | |
Автоматизация браузера (Chromium) | |
Парсинг HTML для информации о товарах | |
Валидация схемы ввода | |
Язык и сборка | |
Фреймворк модульного тестирования |
Лицензия
Этот проект лицензирован по лицензии MIT.
Available Tools
10 toolsadd_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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Search live store shelves, verify delivery windows, and run instant AI agent checkouts.
Turn any shopping list into a ready-to-checkout grocery cart across 26 European supermarkets.
Let your AI agent operate any website through a real, logged-in browser session.
Let AI agents use any website you're logged in to. Sessions stay encrypted on your machine.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to search for products, manage shopping carts, and place grocery orders on Instacart using browser automation. It includes comprehensive tools for store discovery, product searching, and secure checkout with explicit user confirmation.1159 npm12MIT
- FlicenseNot gradedqualityAmaintenanceEnables 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.-
- FlicenseNot gradedqualityAmaintenanceEnables 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.-
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, and access account, order, delivery, and discount information across multiple European online grocery platforms.MIT