CV Forge

CV Forge

あらゆる求人要件に合わせた、強力で ATS フレンドリーな CV を作成します。

求人情報を分析し、完全にマッチした CV を作成するインテリジェントな MCP（Model Context Protocol）サーバーです。

機能

• 求人要件の解析: 求人情報から主要なスキル、資格、メールアドレス、採用担当者名を抽出します
• カスタマイズされた CV の生成: ユーザープロフィールと求人要件に基づいて、カスタマイズされた CV コンテンツを作成します
• カバーレターの生成: 特定の求人応募に合わせたパーソナライズされたカバーレターを生成します
• メールテンプレートの作成: メールアドレスの自動検出機能を備えたプロフェッショナルなメールテンプレートを作成します
• 完全な応募パッケージ: CV、カバーレター、メールテンプレートを 1 つのコマンドで生成します
• デフォルトで PDF: 形式が指定されていない場合は、プロフェッショナルな PDF ドキュメントを自動的に生成します
• 複数の出力形式: PDF（デフォルト）、HTML、Markdown、テキスト形式でドキュメントを生成します
• プロフェッショナルな PDF 生成: プロフェッショナルなスタイリングを施した、出版可能な PDF ドキュメントを作成します
• ATS フレンドリー: 適切なキーワード配置により、応募者追跡システム（ATS）に最適化されています
• スマートな連絡先抽出: 求人情報からメールアドレスと採用担当者名を自動的に抽出します

Star History

インストール

npm 経由（推奨）

グローバルにインストール:

npm install -g cv-forge

またはプロジェクト内にローカルインストール:

npm install cv-forge

ソースから

1. このリポジトリをクローンします
2. 依存関係をインストールします:

   npm install
   

3. プロジェクトをビルドします:

   npm run build
   

使用方法

Claude Desktop への接続

この MCP サーバーを Claude Desktop で使用するには、Claude の設定ファイルに追加する必要があります。

ステップ 1: cv-forge をインストールする

npm install -g cv-forge

ステップ 2: Claude Desktop の設定ファイルを見つける

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

ステップ 3: 設定に MCP サーバーを追加する

グローバルインストールの場合、claude_desktop_config.json ファイルに以下を追加します:

{
  "mcpServers": {
    "cv-forge": {
      "command": "cv-forge"
    }
  }
}

ローカルインストールの場合は、フルパスを指定します:

{
  "mcpServers": {
    "cv-forge": {
      "command": "node",
      "args": ["d:/TopSecret/cv-forge/build/index.js"],
      "cwd": "d:/TopSecret/cv-forge"
    }
  }
}

ステップ 4:（任意）環境設定を追加する

環境変数を使用してサーバーをカスタマイズできます:

{
  "mcpServers": {
    "cv-forge": {
      "command": "cv-forge",
      "env": {
        "DEFAULT_OUTPUT_PATH": "D:/CV",
        "PDF_BASE_FONT_SIZE": "12px",
        "PDF_LINE_HEIGHT": "1.4"
      }
    }
  }
}

ステップ 5: Claude Desktop を再起動する 設定を追加した後、Claude Desktop アプリケーションを再起動します。

ステップ 6: 接続を確認する Claude Desktop で、CV Forge のツールが利用可能になっているはずです。Claude に次のようなツールの使用を依頼できます:

• 「この求人情報を解析して」
• 「私のプロフィールとこの求人に基づいてカスタマイズした CV を生成して」
• 「私の CV を PDF ファイルとして保存して」

MCP サーバーを単体で実行する（テスト用）

テスト用にサーバーを直接実行することもできます:

npm start

サーバーは stdio で動作し、Model Context Protocol を介して通信します。

利用可能なツール

1. parse_job_requirements

求人要件を解析し、CV のカスタマイズに必要な主要情報を抽出します。

パラメータ:

• jobTitle（文字列、必須）: 職種名／役職
• company（文字列、必須）: 会社名
• jobDescription（文字列、必須）: 求人情報の全文
• requirements（配列、任意）: 個別に分離されている場合の具体的な要件
• preferredSkills（配列、任意）: 個別に分離されている場合の歓迎スキル
• location（文字列、任意）: 勤務地
• salaryRange（文字列、任意）: 提示されている場合の給与範囲

2. generate_cv_data

ユーザープロフィールと求人要件に基づいて、カスタマイズされた CV コンテンツを生成します。

パラメータ:

• userProfile（オブジェクト、必須）: 完全なユーザープロフィール情報
• jobRequirements（オブジェクト、必須）: 求人要件オブジェクト

ユーザープロフィールの構造:

{
  "personalInfo": {
    "fullName": "John Doe",
    "email": "[email protected]",
    "phone": "+1-555-0123",
    "location": "City, State",
    "linkedIn": "linkedin.com/in/johndoe",
    "github": "github.com/johndoe",
    "website": "johndoe.com"
  },
  "summary": "Professional summary text...",
  "experience": [
    {
      "jobTitle": "Software Engineer",
      "company": "Tech Corp",
      "location": "City, State",
      "startDate": "2020-01",
      "endDate": "2023-12",
      "description": "Job description...",
      "achievements": [
        "Achievement 1",
        "Achievement 2"
      ]
    }
  ],
  "education": [
    {
      "degree": "Bachelor of Science in Computer Science",
      "institution": "University Name",
      "location": "City, State",
      "graduationYear": "2020",
      "gpa": "3.8",
      "honors": ["Magna Cum Laude"]
    }
  ],
  "skills": {
    "technical": ["JavaScript", "Python", "React"],
    "soft": ["Leadership", "Communication"],
    "languages": ["English", "Spanish"],
    "certifications": ["AWS Certified"]
  },
  "projects": [
    {
      "name": "Project Name",
      "description": "Project description...",
      "technologies": ["React", "Node.js"],
      "url": "github.com/johndoe/project"
    }
  ]
}

3. save_cv_text

CV の内容を整形されたテキストファイルとして保存します。

パラメータ:

• cvData (object, 必須): カスタマイズされた CV データオブジェクト (generate_cv_data から取得)
• outputPath (string, 必須): CV を保存するディレクトリパス
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "generated_cv"

4. generate_cv (推奨 - メインの CV 生成ツール)

カスタマイズされた CV を生成し、指定された場所またはデフォルトフォルダに保存します。フォーマットを指定しない場合は デフォルトで PDF 形式 になります。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• outputPath (string, オプション): CV を保存するディレクトリパス (指定しない場合は DEFAULT_OUTPUT_PATH を使用)
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "professional_cv"
• format (string, オプション): 出力形式 - "pdf" (デフォルト)、"html"、または "markdown"
• pageSize (string, オプション): PDF のページサイズ (例: 'A4'、'Letter'、'Legal') - 指定しない場合は PDF_PAGE_SIZE 環境変数を使用
• margins (object, オプション): top、right、bottom、left プロパティを持つ PDF の余白 (例: '10mm'、'0.8in') - 指定しない場合は PDF_MARGIN_* 環境変数を使用

5. generate_and_save_cv_pdf (レガシー - 代わりに generate_cv を使用してください)

カスタマイズされた CV を生成し、プロフェッショナルな PDF として直接保存します (CV の生成と PDF の作成を 1 ステップで実行します)。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• outputPath (string, オプション): CV を保存するディレクトリパス (指定しない場合は DEFAULT_OUTPUT_PATH を使用)
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "professional_cv"

6. generate_and_save_cv_markdown (推奨)

カスタマイズされた CV を生成し、Markdown として直接保存します (CV の生成と Markdown の作成を 1 ステップで実行します)。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• outputPath (string, 必須): CV を保存するディレクトリパス
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "cv_markdown"

7. generate_and_save_cv_html (推奨)

カスタマイズされた CV を生成し、HTML として直接保存します (CV の生成と HTML の作成を 1 ステップで実行します)。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• outputPath (string, 必須): CV を保存するディレクトリパス
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "cv_html"

8. generate_cv_pdf (上級)

事前に生成された CV データから、プロフェッショナルな PDF ドキュメントとして CV を生成して保存します。

パラメータ:

• cvData (object, 必須): カスタマイズされた CV データオブジェクト (generate_cv_data から取得)
• outputPath (string, 必須): CV を保存するディレクトリパス
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "professional_cv"

9. generate_cv_markdown (上級)

事前に生成された CV データから、Markdown 形式で CV を生成します。

パラメータ:

• cvData (object, 必須): カスタマイズされた CV データオブジェクト (generate_cv_data から取得)
• outputPath (string, 必須): CV を保存するディレクトリパス
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "cv_markdown"

10. generate_cv_html (上級)

事前に生成された CV データから、スタイル付きの HTML ドキュメントとして CV を生成します。

パラメータ:

• cvData (object, 必須): カスタマイズされた CV データオブジェクト (generate_cv_data から取得)
• outputPath (string, 必須): CV を保存するディレクトリパス
• fileName (string, オプション): カスタムファイル名 (拡張子なし)、デフォルトは "cv_web"

カバーレターおよびメールテンプレートツール

11. generate_cover_letter (推奨)

特定の求人応募向けにカスタマイズされたカバーレターを生成します。画面に表示したり PDF として保存したりできる整形済みテキストを返します。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• hiringManagerName (string, 任意): 採用担当者の名前 (わかっている場合)
• format (string, 任意): 出力形式 - 画面表示用の "text" (デフォルト)、スタイル付き表示用の "html"

12. save_cover_letter_pdf

カバーレターを生成し、指定した場所に PDF として保存します。求人票からメールアドレスと採用担当者の名前を自動的に抽出します。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• outputPath (string, 任意): カバーレターの保存先ディレクトリパス
• fileName (string, 任意): カスタムファイル名 (拡張子なし)、デフォルトは "cover_letter"
• hiringManagerName (string, 任意): 採用担当者の名前 (わかっている場合)
• pageSize (string, 任意): PDF のページサイズ (例: 'A4'、'Letter'、'Legal')
• margins (object, 任意): top、right、bottom、left プロパティを持つ PDF の余白

13. generate_email_template

求人応募用のプロフェッショナルなメールテンプレートを生成します。求人票からメールアドレスを自動的に検出します。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• templateType (string, 任意): メールテンプレートの種類 - "application" (デフォルト)、"follow_up"、"inquiry"、"thank_you"
• recipientEmail (string, 任意): 受信者のメールアドレス (任意、求人票から抽出されたメールアドレスが利用可能な場合はそれを使用します)
• hiringManagerName (string, 任意): 採用担当者の名前 (わかっている場合)

14. draft_complete_application (推奨 - オールインワンソリューション)

完全な応募パッケージ (履歴書、カバーレター、メールテンプレート) を作成します。PDF の履歴書とカバーレターを自動生成し、求人票にメールアドレスが見つかった場合はメールテンプレートも生成します。

パラメータ:

• userProfile (object, 必須): 完全なユーザープロフィール情報
• jobRequirements (object, 必須): 求人要件オブジェクト
• outputPath (string, 任意): ファイルの保存先ディレクトリパス
• baseFileName (string, 任意): 生成されるファイルのベースファイル名 (拡張子なし)、デフォルトは "job_application"
• hiringManagerName (string, 任意): 採用担当者の名前 (わかっている場合)

設定

環境変数

MCP サーバーは、Claude Desktop の設定で環境変数を介したさまざまな構成オプションをサポートしています:

{
  "mcpServers": {
    "cv-forge": {
      "command": "node",
      "args": ["path/to/cv-forge/build/index.js"],
      "cwd": "path/to/cv-forge",
      "env": {
        "DEFAULT_OUTPUT_PATH": "D:/CV",
        "TEMP_DIR": "C:/Users/YourName/AppData/Local/Temp/cv-maker",
        "PDF_TIMEOUT": "300000",
        "PDF_PAGE_SIZE": "A4",
        "PDF_MARGIN_TOP": "10mm",
        "PDF_MARGIN_RIGHT": "10mm",
        "PDF_MARGIN_BOTTOM": "10mm",
        "PDF_MARGIN_LEFT": "10mm",
        "PDF_BASE_FONT_SIZE": "12px",
        "PDF_LINE_HEIGHT": "1.4",
        "PDF_H1_FONT_SIZE": "20px",
        "PDF_H2_FONT_SIZE": "15px",
        "PDF_H3_FONT_SIZE": "13px",
        "PDF_PARAGRAPH_SPACING": "8px",
        "PDF_SECTION_SPACING": "12px"
      }
    }
  }
}

構成オプション:

• DEFAULT_OUTPUT_PATH: 履歴書ファイルを保存するデフォルトディレクトリ (outputPath が指定されていないか "./" の場合)
• TEMP_DIR: PDF 生成中の一時ファイル用ディレクトリ
• PDF_TIMEOUT: PDF 生成のタイムアウト (ミリ秒)
• PDF_PAGE_SIZE: デフォルトの PDF ページサイズ - デフォルトは 'A4'
  • 一般的なサイズ: 'A4' (210×297mm)、'Letter' (8.5×11in)、'Legal' (8.5×14in)
• PDF_MARGIN_*: PDF のページ余白 (top、right、bottom、left) - デフォルトは '10mm'
• PDF_BASE_FONT_SIZE: 履歴書本文の基本フォントサイズ (12px ≈ MS Word 9pt、13px ≈ 10pt)
• PDF_LINE_HEIGHT: テキストの行の高さ (コンパクトなレイアウトには 1.4 を推奨)
• PDF_H1_FONT_SIZE: 名前/タイトル見出しのフォントサイズ
• PDF_H2_FONT_SIZE: セクション見出しのフォントサイズ
• PDF_H3_FONT_SIZE: 役職名とサブセクションのフォントサイズ
• PDF_PARAGRAPH_SPACING: 段落間のスペース
• PDF_SECTION_SPACING: 主要セクション間のスペース

Claude Desktop での使用例

Claude Desktop に接続すると、自然言語を使って CV メーカーと対話できます:

1. 求人要件を解析する

"Can you parse this job posting for me:

Job Title: Senior Software Engineer
Company: TechCorp Inc
Description: We are looking for a Senior Software Engineer with 5+ years of experience in JavaScript, React, and Node.js. Must have experience with cloud platforms and agile methodologies. Strong communication skills required."

2. カスタマイズした CV を生成する（シンプルなワンステップのプロセス - デフォルトでは PDF）

"Generate a tailored CV for me based on this job posting:

Job Title: Senior Software Engineer
Company: TechCorp Inc
Job Description: We are looking for a Senior Software Engineer with 5+ years of experience in JavaScript, React, and Node.js. Must have experience with cloud platforms and agile methodologies.

My Profile:
- Full Name: John Doe
- Email: [email protected]
- Phone: +1-555-0123
- Experience: 6 years as Software Engineer at various companies
- Skills: JavaScript, Python, React, Node.js, AWS, Docker
- Education: BS Computer Science from State University

Please save it to C:\Users\John\Documents\CVs with filename 'john_doe_senior_engineer_techcorp'"

注意: 別の形式を指定しない限り、PDF ファイル（デフォルト形式）が自動的に生成されます。

3. さまざまな形式で生成する

"Can you generate my CV in multiple formats? I need:
1. A professional PDF for applications (default format)
2. A Markdown version for my GitHub  
3. An HTML version for my website

Save them all to C:\Users\John\Documents\CVs with the base filename 'john_doe_cv'"

または形式を明示的に指定します:

"Generate my CV in HTML format and save it to C:\Users\John\Documents\CVs"

または PDF のカスタムページサイズと余白を指定します:

"Generate my CV as a PDF with Letter page size and 1 inch margins on all sides, save it to C:\Users\John\Documents\CVs"

3. カバーレターを生成する

"Generate a cover letter for the Senior Software Engineer position at TechCorp Inc. The job description mentions the hiring manager is Sarah Johnson and applications should be sent to [email protected]."

4. メールテンプレートを生成する

"Create an email template for applying to the Senior Software Engineer position at TechCorp Inc. The job posting includes the email [email protected] and mentions Sarah Johnson as the hiring manager."

5. 完全な応募パッケージを作成する（推奨）

"Draft a complete job application package for the Senior Software Engineer position at TechCorp Inc. Include CV, cover letter, and email template. Save everything to C:\Users\John\Documents\Applications with the base filename 'techcorp_application'."

これにより以下が生成されます:

• techcorp_application_CV.pdf - カスタマイズした CV
• techcorp_application_Cover_Letter.pdf - プロフェッショナルなカバーレター
• techcorp_application_Email_Template.txt - メールテンプレート（求人情報にメールアドレスが見つかった場合）

6. フォローアップメールのテンプレートを生成する

"Generate a follow-up email template for the Senior Software Engineer position I applied to at TechCorp Inc last week."

7. ツールの直接使用例

ツールを直接使用したい場合（高度な使用方法）:

1. 求人情報を解析する:

   {
     "tool": "parse_job_requirements",
     "args": {
       "jobTitle": "Senior Software Engineer",
       "company": "TechCorp Inc",
       "jobDescription": "We are looking for a Senior Software Engineer with 5+ years of experience in JavaScript, React, and Node.js. Must have experience with cloud platforms and agile methodologies."
     }
   }
   

2. カスタマイズした CV を生成する:

   {
     "tool": "generate_cv_data", 
     "args": {
       "userProfile": { /* user profile object */ },
       "jobRequirements": { /* job requirements object */ }
     }
   }
   

3. PDF 形式の CV を生成する:

   {
     "tool": "generate_cv_pdf",
     "args": {
       "cvData": { /* tailored CV data */ },
       "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
       "fileName": "senior_engineer_techcorp_cv"
     }
   }
   

4. Markdown 形式の CV を生成する:

   {
     "tool": "generate_cv_markdown",
     "args": {
       "cvData": { /* tailored CV data */ },
       "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
       "fileName": "cv_for_github"
     }
   }
   

5. HTML 形式の CV を生成する:

   {
     "tool": "generate_cv_html",
     "args": {
       "cvData": { /* tailored CV data */ },
       "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
       "fileName": "web_resume"
     }
   }
   

6. CV をテキストファイルとして保存する:

   {
     "tool": "save_cv_text",
     "args": {
       "cvData": { /* tailored CV data */ },
       "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
       "fileName": "senior_engineer_techcorp_cv"
     }
   }
   

仕組み

1. 求人分析: サーバーは求人情報を解析して以下を抽出します:

   • 必須の技術スキル
   • 歓迎される資格
   • 企業の業界と規模
   • 求められる経験レベル

2. CV のカスタマイズ: 分析に基づいて、以下を行います:

   • 関連するスキルと経験を優先する
   • 職務要約を調整する
   • 一致する実績を並べ替えて強調する
   • ATS 最適化のために求人固有のキーワードを取り入れる

3. 出力の生成: 整形されたテキスト CV を作成します。これには以下が含まれます:

   • ATS に優しいフォーマットを使用する
   • 関連するキーワードを含める
   • プロフェッショナルな構成を維持する
   • 最も関連性の高い資格を強調する

ファイル構成

cv-forge/
├── src/
│   ├── index.ts                    # Main MCP server
│   └── lib/
│       ├── job-parser.ts           # Job requirement parsing logic
│       ├── cv-generator.ts         # CV tailoring algorithms
│       ├── document-generator.ts   # Multi-format document generation
│       └── word-generator.ts       # Word document generation (future)
├── build/                          # Compiled JavaScript files
├── package.json                    # Project configuration
├── tsconfig.json                   # TypeScript configuration
├── claude_desktop_config.example.json  # Example configuration
└── README.md                       # This file

開発

ビルド

npm run build

開発サーバーの起動

npm run dev

プロジェクト構成

• src/index.ts: ツール登録を備えたメインの MCP サーバー
• src/lib/job-parser.ts: 求人要項を解析し、主要な情報、メールアドレス、採用担当者名を抽出する
• src/lib/cv-generator.ts: 求人要項に基づいてカスタマイズした CV の内容を生成する
• src/lib/cover-letter-generator.ts: 求人応募用のパーソナライズされたカバーレターを生成する
• src/lib/email-template-generator.ts: さまざまな応募シナリオ向けのプロフェッショナルなメールテンプレートを作成する
• src/lib/document-generator.ts: マルチフォーマットのドキュメント生成（PDF、HTML、Markdown）
• src/lib/word-generator.ts: （将来）Word ドキュメント生成機能

トラブルシューティング

PDF が設定された場所に保存されない

• Claude Desktop の設定で DEFAULT_OUTPUT_PATH が設定されていることを確認してください
• 設定を変更した後は Claude Desktop を再起動してください
• パスが存在するか、アプリケーションにそれを作成する権限があるかを確認してください

フォントサイズが大きすぎる、または小さすぎる

• 環境変数の PDF_BASE_FONT_SIZE を調整してください（12px ≈ 9pt、13px ≈ 10pt MS Word）
• 行間を狭く、または広くするには PDF_LINE_HEIGHT を変更してください
• 変更後は Claude Desktop を再起動してください

PDF の生成に失敗する

• 出力ディレクトリが存在し、書き込み可能であることを確認してください
• TEMP_DIR のパスが有効であることを確認してください
• 十分なディスク容量があることを確認してください

カスタムページサイズが機能しない

• ページサイズが有効な形式（A4、Letter、Legal、A3、A5 など）であることを確認してください
• そのページサイズが PDF ジェネレーターでサポートされていることを確認してください
• 標準的なページサイズ名を使用してください（大文字と小文字を区別します）

カスタム余白が適用されない

• 適切な単位を使用してください: 'mm'、'cm'、'in'、'px'、'pt'
• 例: '10mm'、'0.8in'、'72pt'
• 環境変数を変更した後は Claude Desktop を再起動してください

今後の機能拡張

• 高度な書式設定を備えた Word 文書生成の強化
• 複数の履歴書およびカバーレターのテンプレート（モダン、クラシック、ミニマル）
• 高度なキーワード最適化アルゴリズム
• 求人サイトとの連携による求人情報の自動解析
• LinkedIn プロフィール連携によるプロフィールデータの自動取得
• 求人要件に基づく面接対策の質問
• 市場データに基づく給与交渉のガイダンス
• 国際的な応募に向けた多言語サポート
• AI による文章提案と改善

依存関係

• @modelcontextprotocol/sdk: コアとなる MCP 機能
• zod: スキーマ検証と型安全性
• typescript: TypeScript コンパイラー
• md-to-pdf: Markdown からの PDF 生成
• markdown-it: Markdown の解析と HTML 変換
• docx: Word 文書の生成（将来の Word 出力用）

ライセンス

このプロジェクトは MIT ライセンスの下で利用できます。

コントリビューション

コントリビューションを歓迎します！プルリクエストの送信や、バグや機能リクエストに関する Issue の作成をお気軽にどうぞ。