ats-mcp-server

MCP-сервер, агрегирующий вакансии напрямую из публичных API систем найма (ATS) и джоб-бордов. Один запрос — вакансии из нескольких источников в едином формате, без парсинга HTML и без сторонних агрегаторов.

Сервер отдаёт данные через Model Context Protocol, поэтому подключается к любому MCP-клиенту (Claude и т.п.): клиент вызывает ручку, получает структурированный список вакансий и работает с ним дальше.

Источники

• ATS (публичные API): Greenhouse, Ashby, Lever, Workable
• Джоб-борды: hh.ru, Bayt

Каждый источник — за отдельным провайдером с единым интерфейсом, поэтому добавить новый источник значит написать один класс-провайдер.

Ручки MCP

• search_all — поиск по всем ATS-источникам сразу
• search_hh — поиск по hh.ru
• get_job_details — детали вакансии по идентификатору
• get_stats — статистика по собранным вакансиям
• exclude_jobs / unexclude_job — скрыть/вернуть вакансии в выдаче

Стек

TypeScript, Node.js 24, MCP SDK, Zod (схемы и валидация), SQLite (хранение), Meilisearch (поиск), Vitest (тесты).

Установка

npm ci
cp .env.example .env        # заполнить ключи (см. .env.example)
docker compose up -d        # Meilisearch и сопутствующие сервисы
npm run build

Запуск и разработка

npm run dev          # сервер в watch-режиме (tsx)
npm start            # собранная версия (dist/)

npm run test:run     # тесты (vitest)
npm run check        # tsc --noEmit + eslint + knip
npm run lint:fix     # автоправка линтера

Экспериментальные проверки провайдеров — в src/poc/ (npm run poc:greenhouse, poc:ashby, poc:lever, poc:workable, poc:all).

Лицензия

MIT — файл LICENSE.