Federal Compass MCP — MCP-сервер для Claude Code
Подключает USAJobs к ИИ-агенту: ищет федеральные вакансии, переводит казённый язык объявлений на человеческий и считает зарплату по грейду.
claude mcp add --env USAJOBS_API_KEY=<USAJOBS_API_KEY> --env USAJOBS_EMAIL=<USAJOBS_EMAIL> --transport stdio federal-compass-mcp -- npx -y federal-compass-mcpЧто делает Federal Compass MCP
Сервер даёт агенту инструменты поверх официального USAJobs API. search_jobs ищет вакансии по ключевому слову, местоположению, зарплате, грейду, ведомству и удалёнке, get_job_details открывает полное объявление, а compare_jobs ставит от двух до пяти вакансий рядом. Отдельно есть explain_federal_concept: он растолковывает GS-грейды, ступени, допуски безопасности и пути найма, которые в объявлениях не расшифровываются.
Для перехода из частного сектора есть calculate_salary — расчёт оклада GS с местной надбавкой для грейда, ступени и города. Резюме хранится локально в ~/.federal-compass/cv.json: save_cv его записывает, get_cv читает, find_matching_jobs вытаскивает из него навыки и ищет подходящие позиции, check_qualification сверяет резюме с конкретным объявлением, extract_ksa вытаскивает требования KSA. Текст резюме возвращается вашему MCP-клиенту, и в зависимости от его настроек может уйти провайдеру модели — стоит проверить, что там с приватностью.
Зарегистрируйте бесплатный ключ на developer.usajobs.gov и передайте его вместе с почтой в переменных USAJOBS_API_KEY и USAJOBS_EMAIL, иначе инструменты не пройдут авторизацию. Нужен Node.js от версии 22. Разбор резюме и требований — неофициальная оценка: сроки и условия объявления сверяйте на USAJOBS перед откликом.
Какие задачи решает
- найти федеральные вакансии по ключевому слову и городу
- понять, что такое GS-13 и сколько он платит в конкретной местности
- сравнить несколько объявлений бок о бок
- проверить, подходит ли резюме под требования вакансии
- вытащить требования KSA из текста объявления
Примеры запросов агенту
- Найди федеральные вакансии разработчика в Роли, Северная Каролина
- Объясни, что такое GS-13 и какая у него зарплата
- Сохрани моё резюме и скажи, прохожу ли я по этой вакансии
Как установить Federal Compass MCP
Командой платформы
claude mcp add --env USAJOBS_API_KEY=<USAJOBS_API_KEY> --env USAJOBS_EMAIL=<USAJOBS_EMAIL> --transport stdio federal-compass-mcp -- npx -y federal-compass-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add federal-compass-mcp --env USAJOBS_API_KEY=<USAJOBS_API_KEY> --env USAJOBS_EMAIL=<USAJOBS_EMAIL> -- npx -y federal-compass-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"federal-compass-mcp": {
"command": "npx",
"args": [
"-y",
"federal-compass-mcp"
],
"env": {
"USAJOBS_API_KEY": "<USAJOBS_API_KEY>",
"USAJOBS_EMAIL": "<USAJOBS_EMAIL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"federal-compass-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"federal-compass-mcp"
],
"env": {
"USAJOBS_API_KEY": "<USAJOBS_API_KEY>",
"USAJOBS_EMAIL": "<USAJOBS_EMAIL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e USAJOBS_API_KEY=<USAJOBS_API_KEY> -e USAJOBS_EMAIL=<USAJOBS_EMAIL> federal-compass-mcp npx -y federal-compass-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Federal Compass MCP
Как установить Federal Compass MCP в Claude Code?
Сначала добавьте сервер: claude mcp add federal-compass-mcp -- npx -y federal-compass-mcp. Затем повторите с ключами: `claude mcp add --env USAJOBS_API_KEY=<USAJOBS_API_KEY> --env USAJOBS_EMAIL=<USAJOBS_EMAIL> --transport stdio federal-compass-mcp -- npx -y federal-compass-mcp`.
Что делает Federal Compass MCP?
Ищет вакансии на USAJobs, разбирает объявления простым языком, считает оклад по грейду с местной надбавкой и сверяет ваше резюме с требованиями позиции.
Что нужно для работы?
Node.js v22 или новее, бесплатный ключ USAJobs API и MCP-клиент. Ключ и почту сервер берёт из переменных окружения.
