AI导哈

对话式招聘助手

一款革命性的招聘助手，通过自然语言处理和智能候选人匹配技术，将简历处理转化为对话式招聘体验。

  • by ariafarmani
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ariafarmani/cv-mcp-server

使用说明

🎯 CV MCP服务器-会话式招聘助理

一种革命性的模型上下文协议（MCP）服务器，将CV处理转换为 对话式、招聘人员般的经验。采用高级自然语言解析、智能候选人匹配和招聘人员实际想要使用的直观工具构建。

✨ 是什么让这个特别？

🗣️ 说话像一个真正的招聘人员 -不再有JSON技术响应
🧠 理解自然语言 -“寻找资深Java开发人员”很有效
⚖️ 智能候选人比较 -与专业建议并排分析
🎯 直观的工具 -专为招聘人员的实际思考和工作方式而设计
😅 鼓励错误处理 -有用的建议，而不是技术错误

🚀 快速演示

# Instead of complex JSON queries...
Query: "senior java developers in Netherlands"

# Get recruiter-style responses! 
🎯 **Found 3 candidates for: 'senior java developers in Netherlands'**

Excellent! I've found some strong candidates that could be perfect for this role:

**1. Sarah van der Berg** ⭐ (Senior - 6 years)
   📊 **85% match** • 🏛️ Amsterdam
   💼 Currently: Senior Java Developer at ING Bank
   🔧 Key skills: Java ⭐, Spring Boot ⭐, Microservices 💪

💡 **Next steps:** Try `show candidate 1` or `compare candidates 1, 2, 3`

🛠️ 直观的招聘工具

🔍 自然语言候选人搜索

"find senior java developers"
"python programmers with 3+ years experience"  
"experienced angular developers"
"fullstack engineers with react and node.js"
"devops engineer with docker and kubernetes"

⚖️ 智能候选人比较

"compare candidates 1, 2, 3"
"compare Sarah vs John"
"side by side of my top 3"

获取： 技能矩阵•经验分析•专业建议•下一步

📊 完整数据库概述

"show me all candidates"
"database stats"
"what candidates do I have?"

获取： 经验细分•技术栈分布•位置洞察•热门候选人聚光灯

👤 丰富的候选人档案

"show candidate 1"
"profile of Sarah van der Berg"
"details for candidate 5"

获取： 专业总结•当前职位•主要成就•联系方式•下一步

🔄 对话式数据库管理

"refresh database"
"process new CVs"
"update candidates"

获取： 进度更新•文件处理状态•有用的后续步骤

📋 要求和安装

先决条件

  • Python 3.8+
  • 虚拟环境（推荐）
  • 包含荷兰语/英语简历的PDF文件

快速设置

# 1. Clone and setup
git clone <repository-url>
cd cv-mcp-server
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 2. Install dependencies
pip install -r requirements.txt

# 3. Initialize database
python -c "from src.database import init_database; init_database()"

# 4. Add CV files
mkdir -p data/pdfs
# Copy your PDF files to data/pdfs/

# 5. Process CVs and start
python process_cvs.py
python src/mcp_server.py

🎬 现场试用

测试对话界面

# Quick demo of all tools
python test_intuitive_tools.py --quick

# Full test suite with examples  
python test_intuitive_tools.py

# Test query parsing with 34+ scenarios
python test_query_parsing.py

# See transformation demo (before/after)
python demo_recruiter_experience.py

🧠 高级自然语言处理

智能查询理解

系统自动提取并理解：

🔧 技术技能

  • java → Java、Spring、Spring Boot、JVM、Maven
  • javascript → JS、Node.JS、TypeScript、React、Angular
  • python → Django、Flask、Pandas、NumPy
  • devops → Docker、Kubernetes、AWS、CI/CD

📈 经验水平

  • "senior" → 5+ 多年经验，高级水平
  • "5+ years" → 5 年经验
  • "junior" → 1 年级，初级
  • "lead" → 7+ 年，领导水平

🌍 位置识别

  • "Netherlands", "Dutch", "NL" → 荷兰
  • "Amsterdam" → 阿姆斯特丹🏛️ 表情符号
  • "Rotterdam" → 鹿特丹🚢 表情符号

仅适用的查询示例

✅ "senior fullstack developers in Amsterdam with 7+ years"
✅ "java developers netherlands 5+ years experience"  
✅ "junior react developers in Rotterdam"
✅ "python data scientists senior level"
✅ "DevOps engineers with kubernetes experience"
✅ "lead java architects Netherlands"

📊 项目结构

cv-mcp-server/
├── src/                              # Core implementation
│   ├── mcp_server.py                # Main MCP server with 7 intuitive tools
│   ├── database.py                  # SQLite operations & schema
│   ├── cv_parser.py                 # Advanced PDF text extraction
│   ├── matcher.py                   # Intelligent candidate matching
│   ├── mock_candidates.py           # Realistic test candidate database
│   └── models.py                    # Data structures
├── data/                             # Data directory  
│   ├── pdfs/                        # CV PDF files
│   ├── cv_database.db               # SQLite database
│   └── processed_files.json         # Processing log
├── test_*.py                         # Comprehensive test suite
├── demo_*.py                         # Interactive demonstrations
├── *_SUMMARY.md                     # Feature documentation
└── requirements.txt                 # Dependencies

🌟 主要功能Deep Dive

🎯 对话式招聘经验

  • 回复感觉就像与专业招聘人员交谈
  • 鼓励语言而不是技术错误
  • 带有表情符号和格式的视觉候选人演示文稿
  • 显示当前角色和成就的专业背景

🧠 高级自然语言处理

  • 34+个测试场景，涵盖所有查询格式
  • 基于职位映射的智能技能同义词检测
  • 灵活的经验分析（年、级别、范围）
  • 具有荷兰城市识别功能的位置感知
  • 质量评分和智能建议

⚖️ 智能候选人比较

  • 与熟练度之星并肩进行技能分析
  • 经验水平分析及建议
  • 整体实力评分，便于决策
  • 具有明确理由的专业招聘建议

📊 完整的数据库分析

  • 经验水平细分（初级🌟, 高级的⭐, 铅🏆)
  • 候选池中的技术堆栈分布
  • 荷兰城市表情符号的位置洞察
  • 热门候选人通过关键指标脱颖而出

😅 友好的错误处理

🔍 **No exact matches found for: 'quantum computing specialists'**

Don't worry! Let me suggest some alternatives:

📉 **Try lowering experience requirements:**
   • `senior quantum developer`
   • `quantum computing with 5+ years`

🌟 **Popular searches that work:**
   • `java developer netherlands`
   • `python data scientist`

📈 性能和可扩展性

  • 处理速度： 每个PDF约0.4秒
  • 搜索响应： 对于复杂查询，<0.5秒
  • 内存效率： 单文件处理
  • 智能缓存： 跳过未更改的文件
  • 错误恢复： 单个故障不会停止处理

🧪 综合测试

测试覆盖率

# Core functionality tests
python test_mcp_server.py              # MCP server tools
python test_query_parsing.py           # 34+ query parsing scenarios
python test_intuitive_tools.py         # Full recruiter workflow

# Demonstrations  
python demo_recruiter_experience.py    # Before/after transformation
python demo_natural_language.py        # Natural language examples

# Processing pipeline
python process_cvs.py --test           # CV processing pipeline
python check_results.py               # Validation & quality checks

测试内容

  • ✅ 自然语言查询解析（34+场景）
  • ✅ 带有示例的会话工具响应
  • ✅ 技能同义词检测和职位映射
  • ✅ 经验水平分析（年、资历、范围）
  • ✅ 荷兰和荷兰城市的位置检测
  • ✅ 候选人与专业推荐的比较
  • ✅ 数据库分析和见解生成
  • ✅ 用鼓励性建议处理错误
  • ✅ 带有质量验证的PDF处理流程

🔧 高级配置

环境变量

export CV_DATABASE_PATH="custom/path/cv_database.db"
export PDF_DIRECTORY="custom/pdfs/"
export LOG_LEVEL="DEBUG"

处理选项

# Limit processing for testing
python process_cvs.py --limit 5

# Force reprocess all files  
python process_cvs.py --force

# Test mode (2-3 files only)
python process_cvs.py --test

🏗️ 采用先进技术栈构建

  • MCP（模型上下文协议） -现代人工智能集成标准
  • 高级NLP -具有智能解析的正则表达式模式
  • 数据库 -具有全面模式的高效本地数据库
  • PDF处理 -具有错误处理功能的稳健文本提取
  • 模糊匹配 -智能候选人评分算法
  • 荷兰语/英语支持 -双语简历处理能力

🎯 非常适合

  • 招聘机构 -简化候选人搜索和比较
  • 人力资源部 -高效的简历处理和候选人分析
  • 初创企业 -快速的人才评估和招聘决策
  • 顾问 -专业候选人介绍和报告
  • 任何人 -通过智能匹配处理荷兰语/英语简历

🚀 生产就绪

✅ 稳健的错误处理 -优雅的失败和有益的建议
✅ 综合录井 -详细的处理和解析日志
✅ 性能优化 -高效的文件处理和数据库操作
✅ 质量已验证 -广泛的测试覆盖和验证检查
✅ 用户友好 -直观的工具，使用起来很自然
✅ 证据充分的 -完整的设置说明和示例

📞 支持与贡献

获取帮助

  • 检查综合测试输出以获取示例
  • 查看详细的文档文件（*.md）
  • 针对特定的解析问题使用调试脚本
  • 检查处理日志以排除故障

贡献

  1. 分叉存储库
  2. 创建特征分支(git checkout -b feature/amazing-feature)
  3. 添加新功能的测试
  4. 提交更改(git commit -m 'Add amazing feature')
  5. 推送到分支(git push origin feature/amazing-feature)
  6. 打开拉取请求

🎉 准备好改变您的招聘流程！

🎯 来自技术数据库查询→ 对话式招聘经验
🧠 从复杂的JSON→ 自然语言，只是工作
⚖️ 从基本搜索→ 专业候选人比较
😅 由于技术错误→ 鼓励、有益的指导

立即开始：

git clone <repository-url>
cd cv-mcp-server && python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt && python test_intuitive_tools.py --quick

您的智能招聘助理已准备就绪！ 🚀

内置于❤️ 适用于现代招聘工作流程

相关 MCP