Хакатонный MCP-сервер поиска вакансий hh.ru
SecondHackaton-HackAI
Небольшой MCP-сервер и агент с хакатона Cloud.ru: поиск и карточка вакансий hh.ru через открытый API, без токена доступа
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает публичные вакансии hh.ru, откликов и записи не делает
- Работает без токена доступа к аккаунту hh.ru
Установка
Ручная установка
pip install -r requirements.txtУстановка зависимостей из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект сделан на хакатоне Cloud.ru AI Devtools Hack и состоит из MCP-сервера (main.py) и отдельного тестового ИИ-агента (app/main_agent_test.py) поверх него. По структуре папки app/tools видны инструменты search_vacancies, search_vacancies_advanced, get_vacancy_details и list_uploads. README называет hh.ru API «открытым к использованию», то есть сервер обращается к публичному поиску вакансий без собственного токена, а для работы LLM-агента нужен только ключ LLM_API_KEY в .env. Документация ограничивается README с командами запуска, подробного описания параметров инструментов в репозитории нет.
Для кого. Для тех, кто хочет минимальный рабочий MCP-сервер поиска вакансий hh.ru как основу для своего проекта, а не готовое законченное решение.
Подходит, если
- Нужен простой пример MCP-сервера поиска вакансий hh.ru без токена, от которого можно оттолкнуться
- Нужен готовый Docker-compose и оба транспорта, stdio и SSE, как отправная точка
- Устраивает минимальная документация и хакатонное происхождение проекта
Не подходит, если
- Нужна подробная документация инструментов и параметров: в репозитории есть только README с командами запуска
- Нужен активно поддерживаемый проект: последний пуш датирован декабрем 2025 года, сразу после хакатона
- Нужны продвинутые функции вроде отклика, резюме или аналитики: набор инструментов ограничен поиском и карточкой вакансии
Пример запроса к агенту
Найди вакансии backend-разработчика на hh.ru и покажи детали первых трехОграничения
Документация ограничена коротким README, параметры инструментов нужно смотреть прямо в коде app/tools. Проект не обновлялся с декабря 2025 года, сразу после хакатона Cloud.ru. Файл .env закоммичен в репозиторий (хотя без реального ключа), проверьте это перед использованием чужого форка.
Как отключить. Остановите процесс main.py и уберите сервер из конфигурации MCP клиента.
MCP
- Транспорт
- stdio, sse
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| LLM_API_KEY секрет | Ключ LLM-провайдера для тестового агента, самому MCP-серверу не нужен. |
Проверка безопасности
- Только читает публичные вакансии hh.ru, откликов и записи не делает
- Работает без токена доступа к аккаунту hh.ru
Коротко о README
Короткое README на русском описывает проект как агент для автоматического поиска вакансий hh.ru с хакатона Cloud.ru AI Devtools Hack, называет состав команды и дает команды установки зависимостей, заполнения LLM_API_KEY и раздельного запуска тестового агента и MCP-сервера. Ссылка на видео-инструкцию по установке. Лицензия MIT.
Частые вопросы
Нужен ли токен hh.ru?
Нет, README называет API hh.ru открытым к использованию, сервер ищет вакансии без собственного токена.
Для чего нужен LLM_API_KEY?
Он нужен только тестовому агенту в app/main_agent_test.py, а не самому MCP-серверу.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI