MCP Server for NovaCV

NovaCV 用 MCP サーバー

NovaCV 履歴書サービス API に接続するためのモデルコンテキストプロトコル（MCP）サーバーです。

機能

• 履歴書 PDF の生成
• 利用可能な履歴書テンプレート一覧の取得
• 履歴書テキストの JSON Resume 形式への変換
• 履歴書テキストの分析

API キーの取得

このサービスを使用する前に、NovaCV API キーを取得する必要があります。

1. NovaCV API 公式サイトにアクセスします
2. アカウントに登録するか、ログインします
3. コントロールパネルで「API Keys」または「開発者」セクションを探します
4. 新しい API キーを作成してコピーします
5. MCP サービスの使用時にこのキーを設定します

API キーは安全に保管し、公開の場で共有しないでください。

インストール

# 全局安装
npm install -g mcp-server-novacv

# 或使用 npx 运行
npx mcp-server-novacv --api_key=your_api_key

クイックスタート

方法 1：直接実行（推奨）

最も簡単な方法は、以下のクイックスタートコマンドを使用することです。

# 一键构建并启动服务
npm run run

方法 2：MCP Inspector を使用した開発とテスト

Inspector をワンコマンドでビルドして起動できるコマンドを用意しています。

# 一键构建并启动 Inspector
npm run debug

使用方法

コマンドラインオプション

npx mcp-server-novacv [选项]

选项:
  --api_key=KEY        设置 NovaCV API 密钥
  --api_base_url=URL   设置 API 基础 URL
  --timeout=MS         设置 API 超时时间 (毫秒)
  --help, -h           显示帮助信息
  --version, -v        显示版本信息

環境変数の設定

環境変数を使用して API キーを設定できます。

NOVACV_API_KEY=your_api_key mcp-server-novacv

または、.env ファイルを作成します。

NOVACV_API_KEY=your_api_key
NOVACV_API_BASE_URL=https://api.nova-cv.com

ヒント：API キーはNovaCV API 公式サイトから取得できます。上記の「API キーの取得」セクションを参照してください。

MCP クライアントでの設定

Cursor の設定

Cursor の設定ファイルに追加します。

{
  "mcpServers": {
    "novacv": {
      "command": "npx",
      "args": ["mcp-server-novacv"],
      "env": {
        "NOVACV_API_KEY": "your_api_key"
      }
    }
  }
}

Cherry Studio の設定

Cherry Studio で MCP サービスを設定します。

1. 設定を開きます（左下の設定アイコンをクリックするか、Ctrl+,／Cmd+, を使用します）
2. MCP または Model Context Protocol の設定セクションを探します
3. 新しいサービスを追加し、以下のように設定します。
   • 名前：novacv
   • コマンド：npx
   • 引数：mcp-server-novacv
   • 環境変数：NOVACV_API_KEY を追加し、API キーを設定します

JSON 設定に対応している場合は、以下の内容を追加します。

{
  "novacv": {
    "command": "npx",
    "args": ["mcp-server-novacv"],
    "env": {
      "NOVACV_API_KEY": "your_api_key"
    }
  }
}

利用可能なツール

MCP サーバーは以下のツールを提供します。

• generate_resume_from_text：履歴書テキストをワンクリックで、複数のテンプレートに対応した見栄えのよい PDF 履歴書に変換します。履歴書のテキストを入力するだけで、システムが自動的に形式を変換してプロフェッショナルな PDF ファイルを生成するため、JSON データを手動で処理する必要はありません
• get_templates：利用可能なすべての履歴書テンプレートを取得します。テンプレート ID、名前、サムネイルなどを含む、テンプレート一覧と詳細情報を返します
• convert_resume_text：プレーンテキスト形式の履歴書の内容を標準の JSON Resume 形式に変換します。システムが履歴書の各項目をインテリジェントに識別し、国際的に広く使われている JSON Resume 標準に従って構造化します
• analyze_resume_text：履歴書テキストを詳細に分析し、専門的な評価と改善案を提供します。履歴書の完全性、キーワードの使用状況、スキルの適合度などを分析し、的を絞った最適化の提案を示します

使用例

テンプレート一覧の取得

MCP 対応クライアントで mcp_novacv_get_templates コマンドを使用して、利用可能なすべての履歴書テンプレートを取得します。

履歴書の生成

mcp_novacv_generate_resume_from_text コマンドを使用し、履歴書テキストとテンプレート名を指定して PDF 履歴書を生成します。

履歴書テキストの分析

mcp_novacv_analyze_resume_text コマンドを使用して、プレーンテキストの履歴書を分析します。

履歴書テキストの JSON Resume への変換

mcp_novacv_convert_resume_text コマンドを使用して、履歴書テキストを構造化された JSON Resume 形式に変換します。

開発

# 安装依赖
npm install

# 开发模式（监视文件变化）
npm run dev

# 构建项目
npm run build

# 运行服务（构建并启动）
npm run run

# 使用 MCP Inspector 调试（构建并启动Inspector）
npm run debug

トラブルシューティング

設定中に問題が発生した場合：

1. パッケージが正常にインストールされたことを確認します：npx mcp-server-novacv --version
2. API キーが正しく設定されていることを確認します
3. クライアントのログに関連するエラーメッセージがないか確認します

API キーの問題

API キーに関連するエラーが発生した場合：

• https://api.nova-cv.comから有効な API キーを取得したことを確認します
• キーの有効期限が切れていないか、使用制限を超えていないか確認します
• 新しい API キーを再生成してみます
• 環境変数または設定ファイル内のキーに余分な空白や引用符が含まれていないことを確認します

ライセンス

MIT