Простой MCP-сервер Wildberries на Python

Wildberries MCP

Небольшой Python-сервер MCP для API Wildberries, запускается через uv одним файлом wb.py

MCP-сервер

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • Набор инструментов не задокументирован, поэтому неясно, может ли сервер менять данные в кабинете продавца
Все причины и проверки
Российский стек

roma-mgcom/wildberries-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/roma-mgcom-wildberries-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio --env 'WB_API_KEY=<ваш WB_API_KEY>' wildberries -- uvx --directory FULL/PATH/TO/wildberries-mcp run wb.py

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"wildberries","type":"stdio","command":"uvx","args":["--directory","FULL/PATH/TO/wildberries-mcp","run","wb.py"],"env":{"WB_API_KEY":"<ваш WB_API_KEY>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "wildberries": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add wildberries --env 'WB_API_KEY=<ваш WB_API_KEY>' -- uvx --directory FULL/PATH/TO/wildberries-mcp run wb.py

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.wildberries]
command = "uvx"
args = ["--directory", "FULL/PATH/TO/wildberries-mcp", "run", "wb.py"]
env = { WB_API_KEY = "<ваш WB_API_KEY>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "wildberries": {
      "type": "local",
      "command": [
        "uvx",
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "environment": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "FULL/PATH/TO/wildberries-mcp",
        "run",
        "wb.py"
      ],
      "env": {
        "WB_API_KEY": "<ваш WB_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WB_API_KEYсекрет, обязательная
API key for Wildberries

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит a6411d9.

Текст для агента

Склонируй roma-mgcom/wildberries-mcp, задай WB_API_KEY в конфигурации MCP-клиента и запусти через uv --directory /путь/до/wildberries-mcp run wb.py.

Другие способы из описания автора
{
  "mcpServers": {
    "wildberries": {
      "command": "uv",
      "args": ["--directory", "FULL/PATH/TO/wildberries-mcp", "run", "wb.py"],
      "env": {"WB_API_KEY": "WB_API_KEY"}
    }
  }
}

Фрагмент конфигурации из README проекта.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект дает минимальный MCP-сервер поверх API Wildberries на Python, весь код в одном файле wb.py и запускается через менеджер пакетов uv. README ограничивается фрагментом конфигурации подключения, полного списка и описания инструментов в нем нет.

Для кого. Для тех, кто хочет короткий, читаемый пример MCP-сервера Wildberries на Python и готов сам разобраться в коде.

Подходит, если

  • Нужен компактный пример без лишних зависимостей, чтобы разобраться в подходе
  • Уже используете uv для Python-проектов

Не подходит, если

  • Нужен готовый список инструментов с описанием: README его не дает
  • Нужно широкое покрытие API Wildberries: сервер минимальный

Пример запроса к агенту

Подключись к MCP-серверу Wildberries и покажи, какие инструменты он дает

Ограничения

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

Как отключить. Удалите запись сервера из конфигурации MCP-клиента.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
WB_API_KEY
обязательная, секрет
Ключ API продавца Wildberries

Проверка безопасности

  • Набор инструментов не задокументирован, поэтому неясно, может ли сервер менять данные в кабинете продавца

Коротко о README

README короткий и содержит только фрагмент JSON-конфигурации для подключения сервера через uv run wb.py с переменной WB_API_KEY. Описания инструментов и возможностей в README нет, только запуск через pyproject.toml и uv.lock.

Частые вопросы

Какие переменные окружения нужны?

WB_API_KEY, судя по примеру конфигурации в README.

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483Звезды репозитория
Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28Звезды репозитория
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN
Foxx AIПростой MCP-сервер Wildberries на Python

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.