MCP Server Novacv

🚀 MCP サーバー：NovaCV 履歴書サービス API への接続

この MCP サーバーは、NovaCV 履歴書サービスの API への接続を提供します。様々な履歴書関連の機能を利用でき、履歴書の作成や分析を支援します。

✨ 主な機能

• 履歴書の PDF ファイルを生成します。
• 利用可能な履歴書テンプレートのリストを取得します。
• 履歴書のテキストを JSON Resume 標準形式に変換します。
• 履歴書のテキスト内容を分析し、改善提案を提供します。

📦 インストール

# システム要件：Node.js (推奨バージョン 12+)
# プロジェクトディレクトリで以下のコマンドを実行します：
npm install mcp-server-novacv

🚀 クイックスタート

方法一：サーバーを直接実行する

npx mcp-server-novacv --version  # インストールが成功したか確認する
npx mcp-server-novacv --port=3000  # 指定したポートでサービスを起動する

方法二：MCP Inspector デバッグツールを使用する

npx mcp-server-novacv debug  # デバッグモードを起動する

使用方法

• コマンドライン引数：

  • --port：サーバーの実行ポートを指定します。デフォルトは 3000 です。
  • --env：実行環境（development、production など）を設定します。

• 設定ファイル： config.json ファイルを作成または変更し、以下の内容を追加します。

{
  "api_key": "your_api_key_here",
  "template_dir": "./templates",
  "default_template": "modern-blue"
}

💻 使用例

基本的な使用法

1. 履歴書 PDF を生成する

mcp_novacv_generate_resume_from_text --text="你的简历内容" --template="模板名称"

2. テンプレートリストを取得する

mcp_novacv_get_templates

3. JSON Resume 形式に変換する

mcp_novacv_convert_resume_text --input_file="简历文本路径" --output_file="输出路径"

4. 履歴書内容を分析する

mcp_novacv_analyze_resume_text --file="简历文件路径"

🔧 技術詳細

API キーの取得方法

MCP サーバーを使用する前に、NovaCV の API アクセスキーを取得する必要があります。

1. NovaCV API 公式サイトにアクセスします。
2. アカウントを登録またはログインします。
3. コントロールパネルで "API Keys" または "開発者ツール" のセクションを見つけます。
4. 新しい API キーを作成し、安全に保存します。
5. ドキュメントの説明に従って、キーを MCP サーバーに設定します。

開発とメンテナンス

プロジェクトの開発フロー

1. コードリポジトリをクローンします。

git clone https://github.com/your-repo/mcp-server-novacv.git
cd mcp-server-novacv

2. 依存パッケージをインストールします。

npm install

3. 開発モードで起動します（ファイルの変更をリアルタイムに監視します）。

npm run dev

4. 本番用バージョンをビルドします。

npm run build

5. ビルド後のサービスを起動します。

npm start

デバッグとテスト

• MCP Inspector ツールを使用してデバッグします。

npm run debug

これにより、API リクエストを表示および分析するための対話型コンソールが起動します。

トラブルシューティング

問題が発生した場合は、以下の手順でトラブルシューティングを行います。

1. MCP サーバーが正常にインストールされていることを確認します。npx mcp-server-novacv --version を実行します。
2. 設定ファイルの API キーが正しいことを確認します。
3. コンソールまたはログファイルにエラーメッセージが表示されていないか確認します。

一般的な問題

• API キーの問題：

  • キーが NovaCV プラットフォームで有効で、期限が切れていないことを確認します。
  • 設定ファイルのキーがプラットフォームの設定と一致していることを確認します。

• ネットワーク接続の問題：

  • サーバーとクライアント間のネットワーク通信が正常であることを確認します。

📄 ライセンス

このプロジェクトは MIT オープンソースライセンスに準拠しており、自由な使用、変更、配布が許可されています。