# WB MCP Server

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

## Что такое MCP

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

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

- `get_products(limit, offset)` — возвращает список карточек товаров продавца через Wildberries Content API.
- `get_product_reviews(nmId)` — возвращает отзывы покупателей на товар по его `nmId` через Wildberries Feedbacks API.

## Установка

```bash
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`

```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` с понятным сообщением, а не падает).