Инструмент

Что отвечает

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

get-profile

Возвращает единственную запись профиля Маркоса Альвареса — имя, заголовок, местоположение, доступность и краткую биографию — одним объектом, с подтверждающими цитатами. Используйте это, чтобы быстро ответить на вопрос «кто этот человек» или «какова его текущая доступность/местоположение». Не используйте для послужной истории по ролям (используйте get-experience), для конкретных деталей проектов (используйте search-projects) или для проверки, заявлен ли конкретный навык или технология (используйте get-skill-evidence). Не принимает входных данных. В обычной работе нет исхода «нет результата» — в наборе данных этого сервера всегда ровно один профиль.

«Кто такой Маркос Альварес, и открыт ли он сейчас для новых ролей?»

get-experience

Возвращает каждую запись из истории работы Маркоса Альвареса, соответствующую необязательному структурированному фильтру — компания, теги технологий, диапазон дат ГГГГ-ММ и статус текущий/прошлый — в виде списка, упорядоченного от самых новых к старым, каждая запись с цитатой. Используйте это, чтобы ответить на вопросы «что он делал в компании X», «над чем он работал в году Y» или «чем он занимается сейчас». При вызове без полей фильтра возвращается полная история. Не используйте для краткого профиля (используйте get-profile), для поиска по ключевым словам в описаниях проектов (используйте search-projects) или для проверки, заявлен ли один именованный навык (используйте get-skill-evidence). Фильтр, не соответствующий ни одной роли, возвращает успешный результат с пустым списком, а не ошибку.

«Над чем Маркос работал с 2022 года? Проведите меня по его последним ролям.»

search-projects

Ищет в портфолио проектов Маркоса Альвареса по ключевому слову и/или тегу технологии и возвращает ранжированные совпадения, каждое с оценкой релевантности, объяснением совпавшего поля и цитатой. Сопоставление — это детерминированный поиск по ключевым словам/тегам по названиям проектов, резюме, текстам и тегам технологий — на сегодня нет семантического или основанного на эмбеддингах понимания запроса. Используйте это, когда просят найти или описать конкретные проекты, например «покажи проекты, где использовался React» или «что он построил с Kubernetes». Не используйте для хронологической истории работы (используйте get-experience) или для проверки, заявлен ли навык вообще, с доказательствами или пробелом (используйте get-skill-evidence). Запрос, не соответствующий ни одному проекту, возвращает успешный результат с пустым списком, а не ошибку; пустой запрос или запрос только из пробелов ведёт себя так же.

«Покажи проекты, где Маркос использовал TypeScript или Kubernetes.»

get-skill-evidence

Ищет один именованный навык или технологию и сообщает один из трёх честных исходов: 'claimed' (навык с подтверждающими доказательствами), 'not-claimed' (явный, признанный пробел с собственным заявлением и связанными навыками) или 'unknown' (термин не соответствует ни тому, ни другому). Используйте это, когда спрашивают «знаете ли вы X» или «работали ли вы с Y» об одной конкретной технологии. Не используйте для просмотра полного списка навыков (в этом сервере нет такого инструмента) или для поиска ключевого слова в описаниях проектов (вместо этого используйте search-projects), и это не замена get-experience, когда вопрос касается роли или компании, а не одного навыка. Результат 'not-claimed' или 'unknown' — это нормальный, успешный ответ, а не ошибка — передайте его честно, а не повторяйте попытки или не галлюцинируйте вокруг него.

«Работал ли Маркос с событийно-ориентированными архитектурами? Покажите доказательства.»

search-career

Выполняет нечёткий семантический поиск по полному тексту карьерного контента Маркоса Альвареса (опыт, проекты, навыки, публикации) и возвращает ранжированные выдержки, каждая с оценкой релевантности и цитатой, или явный результат «релевантный контент не найден», когда ничего не превышает порог сходства. Используйте это для открытых, сквозных или концептуальных вопросов, на которые структурированный поиск не может ответить напрямую — например, «работал ли он с событийно-ориентированными архитектурами», «каков его опыт руководства командами», «что-нибудь об оптимизации затрат». Не используйте, когда вопрос сводится к конкретному структурированному поиску, на который детерминированные инструменты уже отвечают точно: get-profile для того, кто он, get-experience для истории работы по роли/компании/диапазону дат, search-projects для поиска проектов по ключевым словам/тегам и get-skill-evidence для проверки одного конкретного именованного навыка или технологии — сначала предпочитайте их и обращайтесь к этому инструменту только если они не подходят. Этот инструмент дороже за вызов (он встраивает запрос) и подчиняется тому же дороже за вызов (он встраивает запрос) и подчиняется тому же общесерверному ограничению скорости, что и любой другой инструмент здесь — не вызывайте его повторно для одного и того же вопроса.

«Каков опыт Маркоса в руководстве инженерными командами и наставничестве?»

Переменная

Назначение

SITE_URL

Необязательное переопределение собственного абсолютного origin сайта. Не требуется — Vercel определяет его автоматически.

UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN

Учётные данные Upstash Redis, обеспечивающие ограничение частоты запросов /api/mcp. Если не заданы, сервис работает без ограничений (fail open), а не завершается ошибкой.

RATELIMIT_MAX_REQUESTS, RATELIMIT_WINDOW_SECONDS

Переопределяют окно ограничения частоты запросов конечной точки MCP.

CHAT_PROVIDER, CHAT_MODEL_ID

Выбирают и фиксируют провайдера/идентификатор модели чат-агента.

GOOGLE_GENERATIVE_AI_API_KEY

Требуется, когда CHAT_PROVIDER=google (значение по умолчанию).

ANTHROPIC_API_KEY

Требуется только когда CHAT_PROVIDER=anthropic.

CHAT_SESSION_RATELIMIT_MAX_REQUESTS, CHAT_SESSION_RATELIMIT_WINDOW_SECONDS, CHAT_IP_RATELIMIT_MAX_REQUESTS, CHAT_IP_RATELIMIT_WINDOW_SECONDS, CHAT_AGENT_MAX_STEPS

Настройка защитных ограничений чата — см. apps/web/README.md «Chat guardrails».

DATABASE_URL

Строка подключения Neon Postgres для модуля @hire-me-mcp/core/db (миграции, приём данных, searchCareer). См. packages/core/README.md.

NEON_API_KEY, NEON_PROJECT_ID

Создание/удаление временной ветки Neon только для набора интеграционных тестов БД — никогда не используется с основной базой данных.