Federal Compass MCP

federal-compass-mcp

助你从私营部门迈向联邦职业的 AI 指南针

联邦职位描述长达 5 页，充斥着法律术语。GS 等级、安全许可级别、招聘途径——这些内容到处都没有解释。federal-compass-mcp 将 Claude 连接到官方的 USAJobs API，将其变成一位能用通俗英语交流的 AI 顾问。

专为从私营部门转向联邦／政府职业的技术专业人士打造。

---

功能

• 搜索联邦职位空缺，可选筛选条件包括关键词、地点、薪资和安全许可级别
• 解读联邦职位描述，转化为通俗易懂的语言——说明雇主的实际要求，不再使用行话
• 支持 CV 分析：向 AI 助手提供你的 CV 和职位要求，以便进行比较
• 讲解联邦相关概念——GS 等级、薪酬计划、安全许可和招聘途径
• 在本地保存你的 CV，方便 Claude 自动查阅

---

开始使用

1. 获取免费的 USAJobs API 密钥

在 developer.usajobs.gov 注册——大约需要 3 分钟。验证电子邮件后，你会收到 API 令牌。

2. 添加到 MCP 客户端

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "federal-compass": {
      "command": "npx",
      "args": ["-y", "federal-compass-mcp@latest"],
      "env": {
        "USAJOBS_API_KEY": "your_api_key",
        "USAJOBS_EMAIL": "[email protected]"
      }
    }
  }
}

VS Code / Cursor / Windsurf——配置相同，但配置文件路径不同。请参阅客户端的 MCP 文档。

3. 试用

Find me senior software developer jobs in Raleigh, NC

What is a GS-13 and how much does it pay?

Save my CV [attach file]

Look at this job posting — am I qualified?

---

工具

工具	描述
search_jobs	搜索联邦职位空缺。所有筛选条件均为可选项——关键词、地点、薪资、等级、机构、远程办公
get_job_details	获取特定职位发布的完整详情
compare_jobs	并排比较 2-5 个职位发布
save_cv	在本地保存你的 CV，供分析时自动使用
get_cv	读取已保存的 CV
explain_federal_concept	讲解 GS 等级、安全许可、招聘途径和薪酬计划
calculate_salary	根据任意等级、阶梯和地点，计算含地区薪酬的 GS 薪资
find_matching_jobs	查找与你的 CV 匹配的职位——提取技能并搜索 USAJobs
check_qualification	将你的 CV 与特定职位发布进行比较
extract_ksa	从职位发布中提取 KSA 要求，并可选择与你的 CV 进行匹配

---

CV 存储与隐私

你保存的 CV 存储在本机：

~/.federal-compass/
  cv.json
  codelists/     <- cached USAJobs reference data

get_cv 和 check_qualification 工具会将你的 CV 文本返回给 MCP 客户端。根据客户端及其配置，该文本可能会发送给 AI 提供商进行处理。分享个人信息前，请查看客户端和提供商的隐私设置。

find_matching_jobs 工具会将从你的 CV 中提取的关键词发送给 USAJOBS，以搜索相关职位空缺。

---

数据来源与独立分析

联邦职位公告和 API 参考数据来自 USAJOBS。API 的使用须遵守 USAJOBS API 服务条款。每位用户都应注册并使用自己的 API 凭据。

这是一个独立项目。它并非由美国人事管理局（OPM）或 USAJOBS 运营、赞助、批准或认可。

AI 说明、简历比较和提取的要求匹配结果均为非官方分析，并非机构对资格的认定。申请前，请对照 USAJOBS 上当前的官方公告核实要求、截止日期和申请说明。

---

为什么联邦职位令人困惑（以及本工具如何提供帮助）

对于来自私营部门的人来说，联邦职位公告读起来就像另一种语言：

• GS-13 Step 1-10 — 我的职级是多少？Step 是什么意思？
• TS/SCI with polygraph — 我需要这个吗？需要多长时间？
• Competitive vs Excepted Service — 我可以申请哪一种？
• HiringPath: fed-transition — 这是什么？为什么重要？

federal-compass-mcp 通过与 Claude 自然对话来解答这些问题。

---

要求

• Node.js v22+
• 免费的 USAJobs API 密钥
• 任意兼容 MCP 的客户端（Claude Desktop、VS Code、Cursor 等）

---

贡献

欢迎提交问题和 PR。请参阅 CONTRIBUTING.md。

---

许可证

MIT — 请参阅 LICENSE

---

由 @skivuha 构建——一位亲身经历从私营部门转向联邦工作的高级前端工程师。