ResumePilot MCP

Claude Desktop向けのスケーラブルなユニバーサル求人応募MCPサーバーです。

Claudeにマスターレジュメを1つ渡すだけで、ResumePilotがそれを解析し、再利用可能なプロフィールを構築し、求人情報をそれと照合して分析し、求人固有のATS/マッチスコアを計算し、情報を決して捏造しないカスタマイズ済みレジュメを生成し、すべての応募をローカルデータベースで追跡し、応募ごとの追跡ページ付きの最終PDFレポートを生成します。

フェーズ1（本リリース） は、完全でテスト済みの、完全ローカル基盤です。求人情報を貼り付けると、パイプライン全体がエンドツーエンドで実行されます — 外部の求人サイトは不要です。グローバル求人検索、応募自動化、メール追跡は、同じアダプターアーキテクチャに組み込まれる後のフェーズです。docs/ARCHITECTURE.md を参照してください。

やらないこと

• ❌ スキル、経験、学歴、資格、数値を決して捏造しません。

• ❌ LinkedIn/NaukriなどのパスワードやOTPを決して保存しません。

• ❌ CAPTCHA、2FA、ボット対策、認証を決して回避しません。

• ❌ 任意のウェブサイトへの自動送信は行いません（フェーズ1は準備のみ。送信はユーザーが行います）。

必要なスキルがユーザーの資料から検証できない場合、ResumePilotは "Required skill not verified from the user's profile."（必要なスキルがユーザーのプロフィールから検証できません）と報告します — 追加はしません。

Related MCP server: resume-tailor-mcp-server

要件

• Node.js ≥ 18.18

• Claude Desktop（MCP利用時）

インストールとビルド

git clone <your-fork-url> resumepilot-mcp
cd resumepilot-mcp
npm install
npm run build
cp .env.example .env    # optional — sensible defaults otherwise

Claudeなしで試す（オフラインデモ）

Claudeが呼び出すのと同じツールを通じてパイプライン全体を一時フォルダで実行します：

npm run demo

元のATSスコアと最適化後のATSスコア、生成されたPDFレポート、HTML追跡ページが表示されます。

テストを実行

npm test

40のテストが、解析、スコアリング、「決して捏造しない」保証、最適化、追跡、レポート作成、エンドツーエンドのツールパイプラインをカバーしています。

ダウンロード（Claude Desktop拡張機能）

すぐにインストールできる拡張機能は Releases ページから入手できます：

拡張機能だけ欲しいですか？ resumepilot.mcpb をダウンロードし、Claude Desktopを開いて → 設定 → 拡張機能 に移動し、ファイルをドラッグして、データフォルダを設定し、オンに切り替えます。

Claude Desktopへのインストール

2つの方法 — 完全な手順は docs/INSTALL.md にあります：

• ワンクリック・デスクトップ拡張機能： npm run bundle で resumepilot.mcpb が生成されます。Claude Desktop → 設定 → 拡張機能 にドラッグし、データフォルダを設定してオンにします。（バンドルにはネイティブSQLiteバイナリが埋め込まれているため、macOS/Windows用には自分のOS上で1コマンドでビルドしてください。）

• 手動MCP設定： ソースからビルドし、mcpServers エントリを追加します。

Claude Desktopへの接続（手動設定）

1. ビルド：npm run build（dist/src/index.js が生成されます）。

2. Claude Desktopの設定ファイルを開きます：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 絶対パスを使用してサーバーを追加します（docs/claude_desktop_config.example.json を参照）：

   {
     "mcpServers": {
       "resumepilot": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/resumepilot-mcp/dist/src/index.js"],
         "env": {
           "RESUMEPILOT_DATA_DIR": "/ABSOLUTE/PATH/TO/your-private-data",
           "ATS_TARGET_SCORE": "90"
         }
       }
     }
   }

4. Claude Desktopを完全に終了して再起動します。ResumePilotのツールがツール（🔌）メニューに表示されます。

使い方

次のように言うだけです：

「ResumePilotの求人応募プロセスを開始してください。」

Claudeはワークフローを理解し、次のことを行います：

1. マスターレジュメを要求 → upload_master_resume（ファイルパスを渡します）。

2. 解析し、不足情報のみを要求 → analyze_master_resume → setup_user_profile。

3. 貼り付けた求人情報を受け取る → analyze_job（元のATSスコアとギャップを表示）。

4. カスタマイズ済みレジュメを構築 → optimize_resume_for_job（元と最適化後のATS、PDF + DOCX）。

5. 応募を準備 → generate_application_profile → prepare_application。

6. 記録 → apply_to_job（フェーズ1：送信はユーザーが行い、Claudeは確認後にAPPLIEDとマークします）。

7. 追跡 → update_application_tracking / search_application_emails。

8. 最終レポートを生成 → generate_application_report（PDF + 追跡ページ）。

プロンプト例

• 「これが私のレジュメです：/Users/me/Documents/resume.pdf。プロフィールを設定してください。」

• 「この求人を私のレジュメと照合して分析してください：<求人情報を貼り付け>」

• 「応募1用にレジュメを最適化して、前後のATSスコアを見せてください。」

• 「何が変わったのか、何が検証できなかったのか教えてください。」

• 「応募レポートを生成してください。」

設定（.env）

セキュリティとプライバシー

• データは RESUMEPILOT_DATA_DIR（git管理外）の下の自分のマシンに留まります。

• 第三者のパスワードやOTPは決して保存されません。将来の統合では、公式のOAuth/セッションフローを使用し、トークンはログに残しません。

• ログはstderrのみに出力され、秘密情報らしき値はマスクされます。

• データディレクトリを削除するだけで、いつでもデータを削除できます。

プロジェクト構成

src/
├── index.ts, server.ts          # MCP stdio server + tool registration
├── context.ts                   # composition root
├── tools/                       # 17 MCP tools (thin, Zod-validated)
├── services/                    # parsing, scoring, optimization, tracking, reports
├── providers/                   # jobs / applications / email adapters (+ registries)
├── database/                    # SQLite schema + repository
├── models/                      # Zod schemas & types
└── utils/                       # config, logger, text/keyword processing, ids
tests/                           # vitest suite (40 tests)
docs/                            # ARCHITECTURE.md, Claude Desktop config
scripts/demo.ts                  # offline end-to-end demo

ロードマップ

フェーズ2：汎用検索アダプター、ワーカープール、重複排除、ランキング、最大1,000件の求人 · フェーズ3：対応求人ソース統合 · フェーズ4：応募アダプター · フェーズ5：Gmail追跡（OAuth） · フェーズ6：ホスト型追跡UI + パッケージング。

ライセンス

MIT — LICENSE を参照してください。