Skip to main content
Glama
globus-mcp

globus-mcp

by toffguy77

globus-mcp

CI Python License: MIT

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, переменные окружения не нужны.

Инструменты

Сессия и авторизация

Инструмент

Назначение

globus_status()

авторизован ли, какой магазин и способ получения выбран

auth_send_code(phone)

отправить SMS-код (формат 79161234567)

auth_login(code)

подтвердить вход кодом

auth_set_token(token)

импортировать JWT из браузера (обходной путь)

auth_logout()

забыть токен, вернуться к анонимной сессии

Контекст получения

От него зависят цены и наличие — выставляйте его до поиска.

Инструмент

Назначение

list_stores(query)

гипермаркеты

list_pickup_points(query)

пункты выдачи

set_purchase_method(method, store_id/pvz_id/address_id)

pickup_store | delivery | pvz

Каталог и поиск

Инструмент

Назначение

search_products(query, page, per_page, sort)

поиск товаров

search_suggest(query)

подсказки, бренды, категории, топ-товары

list_categories()

дерево каталога

category_products(category_url, category_id, filters, …)

товары категории

category_filters(category_id)

доступные фильтры и готовые строки для filters

product_details(product_url)

детальная карточка: состав, БЖУ, срок годности

Контент

Инструмент

Назначение

promotions()

действующие акции со ссылками на каталог

cms_page(code)

произвольная CMS-страница

recommendations(block, product_id)

популярное, рекомендации, комбо, ранее купленное

Корзина

Инструмент

Назначение

cart_view()

состав и итоги

cart_add(product_id, quantity)

добавить к текущему количеству

cart_set_quantity(product_id, quantity)

задать количество, 0 — удалить

cart_clear()

очистить

checkout_info()

получатель, адреса, слоты доставки (только авторизованно)

Оформление заказа и оплата не реализованы намеренно — сервер не может потратить ваши деньги. Собранную корзину видно на сайте под тем же аккаунтом.

Авторизация

Большинству сценариев вход не нужен. Если всё-таки нужен:

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 tools
auth_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

    B3.1/5.0

    Scored across 22 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      11
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      12
      10
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Serves 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