Хакатонный MCP-сервер поиска вакансий hh.ru
SecondHackaton-HackAI
Небольшой MCP-сервер и агент с хакатона Cloud.ru: поиск и карточка вакансий hh.ru через открытый API, без токена доступа
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Python-сервер, который ищет вакансии через открытый API hh.ru
- Ключ LLM нужен только тестовому агенту из репозитория
Установка
- Работает в
- Сервисы
Ручная установка
pip install -r requirements.txtУстановка зависимостей из README.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Python-сервер, который ищет вакансии через открытый API hh.ru
- Ключ LLM нужен только тестовому агенту из репозитория
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект сделан на хакатоне 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 и покажи детали первых трехMCP
- Транспорт
- stdio, sse
- Авторизация
- не нужна
Переменные окружения
LLM_API_KEYсекрет- Ключ LLM-провайдера для тестового агента, самому MCP-серверу не нужен.
Ограничения
Документация ограничена коротким README, параметры инструментов нужно смотреть прямо в коде app/tools. Проект не обновлялся с декабря 2025 года, сразу после хакатона Cloud.ru. Файл .env закоммичен в репозиторий (хотя без реального ключа), проверьте это перед использованием чужого форка.
Как отключить. Остановите процесс main.py и уберите сервер из конфигурации MCP клиента.
Частые вопросы
Нужен ли токен hh.ru?
Нет, README называет API hh.ru открытым к использованию, сервер ищет вакансии без собственного токена.
Для чего нужен LLM_API_KEY?
Он нужен только тестовому агенту в app/main_agent_test.py, а не самому MCP-серверу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
hh.ru — все инструментыMCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы
MCP-сервер с 52 инструментами по официальному API hh.ru: поиск вакансий без токена, резюме и отклики работодателя с токеном, статистика зарплат
hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
MCP-сервер API hh.ru для соискателя: поиск вакансий, данные работодателей, свои резюме и отклики с сопроводительным письмом
MCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение
ats-mcp-server: вакансии из hh.ru и систем найма
ats-mcp-server
MCP-сервер, который собирает вакансии из hh.ru и публичных API Greenhouse, Ashby, Lever, Workable и Bayt в едином формате без парсинга HTML
Коротко о README
Короткое README на русском описывает проект как агент для автоматического поиска вакансий hh.ru с хакатона Cloud.ru AI Devtools Hack, называет состав команды и дает команды установки зависимостей, заполнения LLM_API_KEY и раздельного запуска тестового агента и MCP-сервера. Ссылка на видео-инструкцию по установке. Лицензия MIT.