WWmcp — MCP-серверы для российских, СНГ и развивающихся рынков

WWmcp — это каталог MCP-серверов для API, которые обычно не попадают в западные подборки. Здесь российские и СНГ-сервисы (1С, МойСклад, Wildberries, YooKassa, СДЭК, hh.ru, amoCRM), а ещё платёжные и SMS-провайдеры Турции, Персидского залива, Египта, Эфиопии, Бангладеш и Латинской Америки. На момент последнего прогона каталога — 46 серверов и 566 инструментов. Все они лежат в одном npm-скоупе @theyahia.

Один и тот же MCP-клиент (Claude Desktop, Cursor, VS Code) получает доступ и к российскому складу, и к турецскому SMS-шлюзу, и к бразильской платёжной системе. Писать отдельную обвязку под каждый сервис не нужно: формат MCP у всех один.

Цифры в README не выдуманы. Скрипт scripts/catalog.mjs запускает каждый сервер через stdio, спрашивает у него список инструментов через listTools() и пересобирает каталог. Команда node scripts/catalog.mjs --check роняет CI, если цифры в README разошлись с реальностью.

Что внутри

• Общее ядро @theyahia/mcp-core — авторизация, повторы запросов, структурированные ошибки и два транспорта: stdio и Streamable HTTP.
• TypeScript и Node.js 18+, тесты на vitest, релизы через changesets, CI на GitHub Actions.
• Монорепозиторий на Turborepo и pnpm workspace: серверы лежат в servers/, ядро — в packages/core, пайплайны — в .github/workflows/.
• Генератор серверов — npx @theyahia/create-mcp <name> собирает заготовку из servers/_template/.

Быстрый старт

Сервер подключается к клиенту одной записью в конфиге. Для Claude Desktop это файл claude_desktop_config.json:

{
  "mcpServers": {
    "moysklad": {
      "command": "npx",
      "args": ["-y", "@theyahia/moysklad-mcp"],
      "env": { "MOYSKLAD_TOKEN": "your_token" }
    },
    "cdek": {
      "command": "npx",
      "args": ["-y", "@theyahia/cdek-mcp"],
      "env": { "CDEK_CLIENT_ID": "your_id", "CDEK_CLIENT_SECRET": "your_secret" }
    },
    "yookassa": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": { "YOOKASSA_SHOP_ID": "your_id", "YOOKASSA_SECRET_KEY": "your_key" }
    }
  }
}

Для Cursor и VS Code формат другой — файл .cursor/mcp.json или .vscode/mcp.json, а ключ называется servers вместо mcpServers:

{
  "servers": {
    "yookassa": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "your-shop-id",
        "YOOKASSA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Дальше всё делает ассистент. Один запрос вроде «проверь остаток по SKU TS-100 в МойСклад, посчитай доставку СДЭК до Новосибирска и сделай ссылку на оплату в YooKassa» превращается в цепочку: МойСклад отдаёт остаток и цену, СДЭК считает тариф, YooKassa возвращает платёжную ссылку. Ручной работы с API не остаётся.

Россия и СНГ

39 серверов, 429 инструментов. Это основная часть каталога.

Пара серверов меняет набор инструментов в зависимости от окружения. У retailcrm и aprovodka на это влияют RETAILCRM_READONLY, ONEC_SERVICES и ONEC_WRITE_MODE, а в таблице выше показан вариант по умолчанию. Промпты MCP (через server.prompt) в счётчики инструментов не входят.

Развивающиеся рынки

7 серверов и 72 инструмента за пределами СНГ. Эта половина моложе и покрывает меньше стран.

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

Пакеты за пределами монорепозитория

В npm под тем же скоупом опубликовано ещё 77 пакетов, но их кода в этом репозитории нет. Каждый живёт в своём репозитории или только в npm. Собрать и протестировать их здесь невозможно, поэтому версии и количество инструментов нужно смотреть на странице пакета в npm.

Из заметного: dadata-mcp (DaData — проверка адресов и поиск контрагентов), alfa-bank-mcp (счета и платёжные поручения), sberbank-acquiring-mcp (онлайн-эквайринг Сбера), yandex-direct-mcp и yandex-metrika-mcp, tgstat-mcp (аналитика Telegram-каналов), yandex-webmaster-mcp. Полный список из 77 позиций лежит в README репозитория.

Пример цепочки

Проверка контрагента, заказ, доставка и оплата в одном сценарии — из README:

1. kontur-focus-mcp: search_company("7707083893")   → verify counterparty by INN
2. moysklad-mcp:     create_customer_order(...)     → create sales order
3. cdek-mcp:         calculate_tariff(...)          → get shipping cost
4. cdek-mcp:         create_order(...)              → book delivery
5. yookassa-mcp:     create_payment(...)            → accept payment
6. yookassa-mcp:     create_receipt(...)            → issue fiscal receipt (54-FZ)

Разработка

git clone https://github.com/theYahia/WWmcp.git
cd WWmcp
pnpm install
pnpm build                                # build all workspaces
pnpm test                                 # run tests across the monorepo
pnpm dev --filter @theyahia/moysklad-mcp  # dev a single server
node scripts/catalog.mjs --check          # verify the numbers in the README

Добавить свой сервер проще всего генератором. Он создаёт рабочую заготовку, дальше остаётся реализовать инструменты, прогнать pnpm test, добавить changeset и открыть PR.

npx @theyahia/create-mcp <name> --region <country> --category <type> --base-url <api-url>

Правила проекта описаны в CLAUDE.md, подробности для контрибьюторов — в CONTRIBUTING.md, код поведения — в CODE_OF_CONDUCT.md, уязвимости — в SECURITY.md. Лицензия MIT.

Смежные проекты

Автор вынес готовые сценарии работы с этими серверами в отдельный репозиторий — mcp-skills: e-commerce, HR, маркетинг, финансы. Это набор навыков для агента поверх каталога, а не сами серверы.