MCP Server Novacv

🚀 MCP 服務器用於 NovaCV 簡歷服務 API 接入

MCP 服務器為 NovaCV 簡歷服務提供 API 接入功能，能助力用戶生成簡歷 PDF、獲取模板列表等，為簡歷處理帶來便利。

🚀 快速開始

在使用 MCP 服務器之前，您需要獲取 NovaCV 的 API 訪問密鑰：

1. 訪問 NovaCV API 官網
2. 註冊或登錄您的賬戶
3. 在控制面板中找到 "API Keys" 或 "開發者工具" 部分
4. 創建新的 API 密鑰並妥善保存
5. 按照文檔說明將密鑰配置到 MCP 服務器中

✨ 主要特性

• 生成簡歷 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="簡歷文件路徑"

📚 詳細文檔

項目開發流程

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 開源協議，允許自由使用、修改和分發。