globus-mcp
Provides integration with the Globus online grocery store, enabling product search, catalog browsing, category filters, product details, promotions, recommendations, cart management, and optional authorized access for checkout information.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@globus-mcp Найди молоко Parmalat дешевле 150 рублей и положи 2 в корзину"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
globus-mcp
MCP-сервер к интернет-магазину ГЛОБУС (online.globus.ru): поиск, каталог,
карточки товаров, акции, рекомендации и корзина — прямо из диалога с LLM.
Python + MCP SDK, транспорт stdio, запускается локально. 22 инструмента.
Не является официальным продуктом ООО «ГИПЕРГЛОБУС». Проект не аффилирован с сетью ГЛОБУС, не одобрен ею и использует незадокументированный внутренний API сайта, который может измениться или закрыться в любой момент. Используйте на свой риск и в рамках пользовательского соглашения сайта.
Что умеет
> найди молоко parmalat дешевле 150 рублей и положи два в корзину
search_products("молоко parmalat", sort="price_asc")
cart_add("26730_ST", 2)
cart_view()
→ Молоко Parmalat 3.5% 1л — 129,99 ₽ × 2 = 259,98 ₽Каталог, поиск, карточки, акции и корзина работают анонимно — вход по SMS нужен
только для оформления (checkout_info) и истории покупок.
Related MCP server: E-Commerce MCP Server
Установка
Нужен Python 3.10+.
git clone https://github.com/toffguy77/globus-mcp.git
cd globus-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e .Проверить, что сервер собрался:
globus-mcp --help 2>/dev/null || echo "сервер запускается только как stdio-процесс"Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или
%APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"globus": {
"command": "/абсолютный/путь/globus-mcp/.venv/bin/globus-mcp"
}
}
}Claude Code
claude mcp add globus -- /абсолютный/путь/globus-mcp/.venv/bin/globus-mcpЛюбой другой MCP-клиент
Команда — globus-mcp, транспорт — stdio, переменные окружения не нужны.
Инструменты
Сессия и авторизация
Инструмент | Назначение |
| авторизован ли, какой магазин и способ получения выбран |
| отправить SMS-код (формат |
| подтвердить вход кодом |
| импортировать JWT из браузера (обходной путь) |
| забыть токен, вернуться к анонимной сессии |
Контекст получения
От него зависят цены и наличие — выставляйте его до поиска.
Инструмент | Назначение |
| гипермаркеты |
| пункты выдачи |
|
|
Каталог и поиск
Инструмент | Назначение |
| поиск товаров |
| подсказки, бренды, категории, топ-товары |
| дерево каталога |
| товары категории |
| доступные фильтры и готовые строки для |
| детальная карточка: состав, БЖУ, срок годности |
Контент
Инструмент | Назначение |
| действующие акции со ссылками на каталог |
| произвольная CMS-страница |
| популярное, рекомендации, комбо, ранее купленное |
Корзина
Инструмент | Назначение |
| состав и итоги |
| добавить к текущему количеству |
| задать количество, |
| очистить |
| получатель, адреса, слоты доставки (только авторизованно) |
Оформление заказа и оплата не реализованы намеренно — сервер не может потратить ваши деньги. Собранную корзину видно на сайте под тем же аккаунтом.
Авторизация
Большинству сценариев вход не нужен. Если всё-таки нужен:
auth_send_code("79161234567") # придёт SMS
auth_login("1234") # код из SMSВторой шаг проверен не до конца (см. Ограничения). Обходной путь —
взять JWT из авторизованного браузера: открыть www.globus.ru, в консоли выполнить
__NEXT_DATA__.props.pageProps.tokenи передать строку в auth_set_token(...). Токен живёт около часа.
Безопасность
Состояние сессии лежит в ~/.globus-mcp/state.json с правами 600:
идентификатор устройства (app_id), телефон последнего входа и JWT в открытом виде.
Не коммитьте этот файл и не прикладывайте его к issue.
auth_logout()стирает токен.Каталог состояния переопределяется переменной
GLOBUS_MCP_HOME.Удаление файла целиком даёт новую анонимную сессию с пустой корзиной.
checkout_info() возвращает персональные данные (имя, телефон, адреса) — они попадут
в контекст модели. Инструмент отдаёт выжимку, а не сырой ответ API, но осторожность
не помешает.
Ограничения
Сайт закрыт для зарубежных IP — сервер должен работать с российского адреса.
Рецептов у ГЛОБУСа нет — ни раздела, ни CMS-страницы. Ближайшая замена —
recommendations(block="combo_tape")и подборки вpromotions().Второй шаг SMS-логина не подтверждён на живом входе. Первый шаг (
POST /api/oauth/loginс{phone}) проверен, формат подтверждения кодом ({phone, code}) угадан. Если он не сработает — используйтеauth_set_token.Избранное и история заказов — эндпоинты не найдены, не реализованы.
API незадокументирован: Swagger/OpenAPI не публикуется, всё разведано вручную. Ломается без предупреждения.
Разработка
pip install -e ".[dev]"
pytest # 76 тестов, все офлайн
ruff check .Тесты не ходят в сеть и не трогают ~/.globus-mcp: транспорт подменяется
httpx.MockTransport, каталог состояния — временным.
Инструменты — обычные функции модуля, поэтому отлаживаются без запуска сервера:
from globus_mcp.server import search_products
print(search_products("молоко", per_page=3))Устройство API и разведанные эндпоинты — docs/API.md.
Как присылать изменения — CONTRIBUTING.md.
Изменения в main принимаются только через pull request.
Лицензия
MIT © Dmitry Spasskiy
Available Tools
22 toolsauth_loginA
Подтвердить вход кодом из SMS. Полученный токен сохраняется локально в ~/.globus-mcp/state.json.
Inputs: code (required), phone. Returns: object
auth_logoutA
Забыть сохранённый токен (сессия становится анонимной).
Inputs: no named parameters. Returns: object
auth_send_codeA
Отправить SMS-код на телефон (формат 79161234567). Первый шаг входа.
Inputs: phone (required). Returns: object
auth_set_tokenA
Импортировать JWT напрямую (взять из NEXT_DATA.props.pageProps.token на www.globus.ru в авторизованном браузере). Обходной путь, если SMS-логин не отработал.
Inputs: token (required). Returns: object
cart_addC
Добавить товар к тому, что уже лежит в корзине.
Inputs: product_id (required), quantity. Returns: object
cart_clearA
Убрать из корзины все товары.
Inputs: no named parameters. Returns: object
cart_set_quantityA
Задать количество товара в корзине. quantity=0 удаляет товар. Для весовых товаров шаг задаётся полем basket_step в карточке.
Inputs: quantity (required), product_id (required). Returns: object
cart_viewA
Содержимое корзины и итоги (цены в рублях).
Inputs: no named parameters. Returns: object
category_filtersB
Доступные фильтры категории. Значения отдаются как "<id фильтра>:<id значения>" — эту строку кладут в аргумент filters у category_products.
Inputs: category_id (required), values_limit. Returns: result
category_productsA
Товары категории. category_url и category_id берутся из list_categories или search_products.categories.
filters — список строк "<id фильтра>:<id значения>" из category_filters, например ["3:17134"] (бренд Parmalat). У флаговых фильтров значение — "да", например ["2147483644:да"] — только товары со скидкой.
Inputs: category_id (required), category_url (required), page, sort, +2 more. Returns: object
checkout_infoA
Данные оформления: получатель, адреса, доступные слоты доставки, итоги. Требует авторизации. Заказ не оформляет.
Возвращает выжимку, а не сырой ответ: в нём лежат персональные данные (ФИО, телефон, полные адреса), и вываливать его целиком в контекст модели не нужно.
Inputs: no named parameters. Returns: object
cms_pageB
Произвольная CMS-страница BFF по коду (например divorce_shares, main). Полезно для подборок и лендингов.
Inputs: code (required). Returns: object
globus_statusA
Текущее состояние сессии: авторизован ли пользователь, какой магазин/способ получения выбран, идентификатор устройства.
Inputs: no named parameters. Returns: object
list_categoriesB
Дерево каталога (верхний уровень и подкатегории).
Inputs: with_children. Returns: result
list_pickup_pointsB
Пункты выдачи заказов (ПВЗ). query фильтрует по названию/адресу.
Inputs: query. Returns: result
list_storesB
Гипермаркеты ГЛОБУС. query фильтрует по названию/адресу.
Inputs: query. Returns: result
product_detailsA
Детальная карточка товара. product_url — ссылка или slug вида moloko-parmalat-35-1l-26730_ST (берётся из поля url в результатах поиска).
Inputs: product_url (required). Returns: object
promotionsB
Действующие акции и подборки со ссылками на каталог.
Inputs: no named parameters. Returns: object
recommendationsA
Ленты товаров: популярное, рекомендации и комбо к товару (нужен product_id), ранее купленное и просмотренное (для авторизованной сессии).
Inputs: block, product_id. Returns: result
search_productsC
Поиск товаров. sort: default | price_asc | price_desc | discount_desc | name_asc | name_desc.
Inputs: query (required), page, sort, per_page. Returns: object
search_suggestC
Подсказки поиска: варианты запросов, бренды, категории и топ-товары.
Inputs: query (required), limit. Returns: object
set_purchase_methodA
Выбрать способ получения и точку. Цены и наличие зависят от него.
pickup_store — самовывоз из гипермаркета (нужен store_id из list_stores); delivery — доставка по адресу (нужен address_id из профиля); pvz — пункт выдачи (нужен pvz_id из list_pickup_points).
Inputs: method (required), pvz_id, store_id, address_id. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Most tools have clearly distinct resource+action purposes, especially the auth_, list_, search_, and cart_ groups. A few pairs, such as search_products vs. category_products and cart_add vs. cart_set_quantity, sit close together, but the descriptions are specific enough to resolve the ambiguity.
Tool names are readable and often grouped by prefixes like list_, auth_, search_, and cart_, but the convention is inconsistent. Bare nouns such as promotions and recommendations coexist with noun-ish names like product_details and checkout_info, and cart_set_quantity contrasts with set_purchase_method in word order.
22 tools cover a broad e-commerce workflow from authentication through catalog browsing, cart management, and checkout info, so the size is defensible. However, the count is on the heavy side of the calibration range, with some optional extras like auth_set_token, cms_page, and search_suggest that are not strictly required for the core flow.
Catalog, cart, and pre-checkout coverage are solid, but the checkout flow is a dead end: checkout_info explicitly does not place an order, and there is no order placement or order history tool. Auth is covered, but profile/address management is missing, leaving significant gaps for a shopping-focused MCP server.
Maintenance
Related MCP Connectors
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
MCP server of "Usilitel Signala" (usilitel-signala.ru), an online shop and installer of cellular signal boosters in Moscow and the Moscow region, Russia. It gives AI assistants live, read-only access to the catalog: repeaters, ready-made kits, boosters, antennas, coaxial cable and cable assemblies, 4G routers and accessories from VEGATEL, Baltic Signal, DalSvyaz and KROKS — more than 1,100 products. Features: • product search and comparison with live prices and stock (synced with the website every 5 minutes); • equipment picks for a site: area, mobile operator or frequency band, calls or internet; • texts of catalog sections, collections, installation services and blog articles; • recent catalog changes: new products, price and stock updates; • contacts, delivery, payment and returns; • a link to the order form on the website, pre-filled with the selection — the customer enters the phone number on the website; no personal data passes through the assistant. Read-only, no authentication required. Data language: Russian.
Multi-tenant MCP gateway for AI commerce. One connection, every store.
Multi-tenant MCP gateway for AI commerce. One connection, every store.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with the Rami Levy Online Grocery Store API, allowing users to perform product searches, add or remove items from their cart, and prepare for checkout, all while integrating with MCP-enabled LLMs.11MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage products, shopping carts, and orders in an online store through a well-defined MCP API.-
- AlicenseCqualityDmaintenanceEnables AI assistants and MCP clients to search Pyaterochka stores, browse categories, find products with filters for price, brand, and promotions, and retrieve product details, store hours, and promotion conditions through the exposed MCP tools.1210MIT
- AlicenseNot gradedqualityBmaintenanceServes a product store's catalog over MCP tool calls so agents can search products, add items to a cart, inspect the cart, and complete checkout without parsing full HTML pages. This keeps action payloads and token usage far smaller than DOM scraping, especially as catalogs grow, and also works through Chrome's native document.modelContext API.MIT