io.github.theYahia/dadata-mcp

MCP-сервер для DaData — подсказки адресов, проверка компаний по ИНН и очистка данных через ИИ

Если вы искали, как подключить DaData к нейросети, пробить контрагента по ИНН, разобрать адрес на составные части или почистить базу телефонов и email — это оно. 31 инструмент вместо ~4 у официального DaData MCP: адреса, компании, банки, телефоны, паспорта, автомобили, геокодирование и 12 справочников, из них 23 метода бесплатны. Ставится локально через npx, без внешнего хостинга — ключ остаётся у вас. Часть серии WWmcp (46 серверов) by @theYahia.

English version (README.en.md)

Почему этот, а не официальный MCP от DaData?

У DaData есть официальный MCP-сервер с 4 инструментами. Наш пакет покрывает весь API:

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

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "dadata": {
      "command": "npx",
      "args": ["-y", "@metarebalance/dadata-mcp"],
      "env": {
        "DADATA_API_KEY": "ваш-api-ключ",
        "DADATA_SECRET_KEY": "ваш-секретный-ключ"
      }
    }
  }
}

Claude Code

claude mcp add dadata -- npx -y @metarebalance/dadata-mcp

VS Code / Cursor

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "dadata": {
      "command": "npx",
      "args": ["-y", "@metarebalance/dadata-mcp"],
      "env": {
        "DADATA_API_KEY": "ваш-api-ключ",
        "DADATA_SECRET_KEY": "ваш-секретный-ключ"
      }
    }
  }
}

Windsurf

Добавьте в настройки MCP Toolkit:

{
  "mcpServers": {
    "dadata": {
      "command": "npx",
      "args": ["-y", "@metarebalance/dadata-mcp"],
      "env": {
        "DADATA_API_KEY": "ваш-api-ключ",
        "DADATA_SECRET_KEY": "ваш-секретный-ключ"
      }
    }
  }
}

Инструменты (31)

Адреса (3)

Компании (8)

Банки (1)

ФИО (2)

Контакты (3)

Паспорта (3)

Автомобили (2)

Геолокация (2)

Почта и страны (2)

Логистика (1)

Композитная проверка (1)

Справочники (1 инструмент, 12 справочников)

Личный кабинет (2)

Ресурсы

• dadata://reference/quality-codes — Расшифровка кодов качества DaData (qc, qc_geo) и уровней достоверности
• dadata://reference/capabilities — Возможности API: бесплатные/платные функции, лимиты

Промпты

• check_counterparty — Проверка контрагента по ИНН: статус, руководитель, финансы, оценка риска
• validate_address — Пошаговая валидация адреса с оценкой качества

Переменные окружения

Тарифы и лимиты

Подробнее: dadata.ru/pricing

• Бесплатный тариф: до 10 000 запросов в сутки. Достаточно для разработки и небольших проектов.
• Тариф «Максимальный» необходим для:
  • find_affiliated — поиск аффилированных компаний (не работает на бесплатном тарифе)
  • find_company_by_id — полные данные (финансы, все коды ОКВЭД приходят только на «Максимальном»; базовая информация доступна бесплатно)
• Платные инструменты (clean_*) — от 0.20 ₽ за запрос, требуют DADATA_SECRET_KEY

Примеры запросов

Найди компанию по ИНН 7707083893

Стандартизируй адрес: мск сухонская 11 кв 89

Проверь контрагента с ИНН 7736207543 — компания действует?

Какой город у IP 46.226.227.20?

Найди БИК и корсчёт Сбербанка

Проверь паспорт 4510 235857 — есть в реестре недействительных?

Найди ОКВЭД для «разработка программного обеспечения»

Безопасность

• API-ключи никогда не логируются и не попадают в ответы об ошибках
• Все входные данные валидируются через Zod-схемы
• Защита от path traversal при построении эндпоинтов
• Жёсткий таймаут 10 секунд на все HTTP-запросы
• Повторные попытки с экспоненциальным backoff только на временные ошибки (429, 5xx)
• stdout зарезервирован для JSON-RPC — логи идут в stderr

Разработка

git clone https://github.com/theYahia/dadata-mcp.git
cd dadata-mcp
npm install
npm run build
npm test

Тест через MCP Inspector

DADATA_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

Откроется интерактивный UI на http://localhost:6274 для вызова инструментов и просмотра JSON-RPC сообщений.

Часть серии WWmcp

Этот сервер — часть открытой серии MCP-серверов для российских API:

46 MCP-серверов для российских API: github.com/theYahia/WWmcp

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai