WB MCP Server

MCP-сервер (Model Context Protocol) для доступа к данным продавца Wildberries: список карточек товаров и отзывы покупателей. Написан на TypeScript, работает через stdio-транспорт и использует официальные Wildberries API.

Что такое MCP

MCP — это открытый протокол для подключения AI-ассистентов к внешним источникам данных и инструментам. Проще говоря, MCP позволяет таким приложениям, как Claude Desktop, вызывать ваши локальные программы и через них получать актуальную информацию — например, список товаров или отзывы из Wildberries.

Этот сервер реализует два MCP-инструмента:

• get_products(limit, offset) — возвращает список карточек товаров продавца через Wildberries Content API.

• get_product_reviews(nmId) — возвращает отзывы покупателей на товар по его nmId через Wildberries Feedbacks API.

Related MCP server: hermes-marketplace-tools

Установка

npm install
cp .env.example .env   # вписать свой WB_API_KEY
npm run build

Подключение к Claude Desktop

Добавьте сервер в конфигурацию claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wb-mcp-server": {
      "command": "node",
      "args": ["/полный/путь/к/wb-mcp-server/dist/index.js"],
      "env": {
        "WB_API_KEY": "ваш_токен_продавца_Wildberries"
      }
    }
  }
}

Демо-режим и ограничения

Без WB_API_KEY сервер запускается и отвечает на initialize/tools/list, но вызовы get_products/get_product_reviews возвращают ошибку с понятным сообщением вместо падения. Это демонстрационный проект: код реализует правильную структуру запросов к официальному Wildberries API (Bearer-токен, эндпоинты Content/Feedbacks API), но не проверялся на реальном аккаунте продавца — для этого нужен собственный API-ключ.

Как это проверено

Сервер запущен как дочерний процесс, и через stdio отправлены реальные JSON-RPC запросы: initialize (успешный handshake), tools/list (обе схемы инструментов возвращаются корректно), tools/call для get_products без ключа (корректно возвращает isError: true с понятным сообщением, а не падает).