# costco

Подключает историю покупок из сети Costco к вашему ИИ-ассистенту. Позволяет запрашивать чеки из оффлайн-складов и онлайн-заказы без выгрузки файлов вручную.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: thehesiod
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/thehesiod/costco-mcp
- Обновлён: 2026-09-25
- HTML: https://affpapa.org/nevibecode/mcp/costco

## Что делает

Сервер связывается с внутренним GraphQL API Costco напрямую через протокол HTTP/2. Для работы не нужен браузер. Данные приходят в виде чеков с позициями и скидками. Каталог товаров кешируется локально в SQLite по пути `~/.costco-mcp/products.db`.

Авторизация построена на refresh-токенах Azure AD B2C со сроком действия около 90 дней. Токен берут из хранилища браузера вручную или запускают скрипт `costco-auth-browser`. Профиль можно переключать. Сервер поддерживает раздельные конфигурации для личного или семейного аккаунта.

Инструмент опирается на неофициальные эндпоинты сети. Любые изменения на серверах магазина сломают интеграцию. Токены лежат на диске в открытом виде в папке `~/.costco-mcp/`, поэтому безопасность зависит от прав на домашнюю папку.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add costco -- uvx costco-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add costco -- uvx costco-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "costco": {
            "command": "uvx",
            "args": [
                "costco-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "costco": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "costco-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add costco uvx costco-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>

## Когда брать
- получить детализацию покупок из физических складов по штрихкоду чека
- выгрузить список онлайн-заказов за выбранный диапазон дат
- узнать наименования товаров и отделы по внутренним артикулам
- вести раздельный учёт расходов для нескольких аккаунтов

## Примеры запросов агенту
- Покажи все чеки из магазина Costco за прошлый месяц по аккаунту personal
- Найди в истории онлайн-заказов позиции со словом coffee
- Разбери чек со штрихкодом 123456789 и покажи итоговую сумму скидок

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44591
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5469
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2197
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md