Federal Compass MCP

federal-compass-mcp

民間企業から連邦政府でのキャリアへの、あなたのAIコンパス

連邦政府の求人票は、法律用語で書かれた5ページにも及ぶものです。GS等級、セキュリティクリアランスのレベル、採用経路などについて、説明している場所はほとんどありません。federal-compass-mcp はClaudeを公式の USAJobs API に接続し、平易な英語で案内するAIアドバイザーに変えます。

民間企業から連邦政府・政府機関でのキャリアへの転職を目指す技術職の方に向けて作られています。

---

できること

• 検索 — キーワード、勤務地、給与、セキュリティクリアランスレベルなどの任意の条件で連邦政府の求人を検索します
• 翻訳 — 連邦政府の求人票を平易な言葉に置き換え、専門用語を使わずに、実際に求められていることを説明します
• 履歴書の分析をサポート — 履歴書と求人要件をAIアシスタントに渡して比較できます
• 説明 — GS等級、給与体系、セキュリティクリアランス、採用経路など、連邦政府に関する概念を解説します
• 履歴書の保存 — 履歴書をローカルに保存して、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	分析で自動的に使用できるように、履歴書をローカルに保存します
get_cv	保存した履歴書を読み取ります
explain_federal_concept	GS等級、セキュリティクリアランス、採用経路、給与体系を説明します
calculate_salary	任意の等級、ステップ、勤務地について、地域手当込みのGS給与を計算します
find_matching_jobs	履歴書に合う求人を探します。スキルを抽出し、USAJobsを検索します
check_qualification	履歴書と特定の求人掲載を照合します
extract_ksa	求人掲載からKSA要件を抽出し、必要に応じて履歴書との照合も行います

---

履歴書の保存とプライバシー

保存した履歴書はお使いのマシンにローカル保存されます。

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

get_cv および check_qualification ツールは、履歴書のテキストをMCPクライアントに返します。クライアントとその設定によっては、そのテキストが処理のためにAIプロバイダーへ送信される場合があります。個人情報を共有する前に、クライアントとプロバイダーのプライバシー設定を確認してください。

find_matching_jobs ツールは、履歴書から抽出したキーワードをUSAJOBSに送信し、関連する求人を検索します。

---

データソースと独立した分析

連邦政府の求人情報とAPIの参照データは、USAJOBSから取得しています。APIの利用には、USAJOBS API利用規約が適用されます。各ユーザーは、自身でAPI認証情報を登録して使用してください。

本プロジェクトは独立したプロジェクトです。米国人事管理局（OPM）またはUSAJOBSによって運営、後援、承認、推奨されているものではありません。

AIによる解説、履歴書との比較、抽出された要件との照合結果は、公式な適格性の判定ではなく、非公式な分析です。応募する前に、USAJOBSに掲載されている最新の公式求人情報で、要件、締め切り、応募方法を確認してください。

---

連邦政府の求人が分かりにくい理由（そして、このツールが役立つこと）

民間企業から転職する人にとって、連邦政府の求人情報は別の言語のように感じられます。

• GS-13 Step 1-10 — どのグレードに当たるのでしょうか？ステップとは何でしょうか？
• TS/SCI with polygraph — これが必要でしょうか？取得にはどのくらいかかるのでしょうか？
• 競争任用と例外任用 — どちらに応募できるのでしょうか？
• HiringPath: fed-transition — これは何で、なぜ重要なのでしょうか？

federal-compass-mcpは、Claudeとの自然な会話を通じて、これらすべてに回答します。

---

要件

• Node.js v22+
• 無料のUSAJobs APIキー
• MCP対応クライアント（Claude Desktop、VS Code、Cursorなど）

---

貢献

課題の報告やプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。

---

ライセンス

MIT — LICENSEをご覧ください。

---

@skivuhaが作成 — 民間企業から連邦政府への転職を自ら経験しているシニアフロントエンドエンジニアです。