Ehiring MCP

基本招聘助理MCP服务器

一个强大的模型上下文协议（MCP）服务器，用于与Base.vn Hiring API交互，以管理招聘工作流程、候选人数据和面试时间表。

🚀 特性

• 职位描述（JD）：检索职位描述和空缺详情（“Tra cứu").
• 候选人名单搜索、筛选和候选列表。
• 深入探究检索详细的候选人信息，包括简历文本和评论（“详细和深入分析”）。
• 面试日程安排管理和查询面试计划。
• 录用管理摘录报价函（“报价阶段”）。
• 智能搜索：基于余弦相似度的空缺和候选人模糊匹配。
• 情境感知：使用FastMCP Context构建，用于增强日志记录和依赖注入。

📋 先决条件

• Python 3.10+
• Base.vn API访问
• 基本帐户API密钥（可选，用于用户信息丰富的评论）

🔧 安装

1. 克隆存储库：

git clone https://github.com/FOX2920/Ehiring-MCP.git
cd Ehiring-MCP

1. 安装依赖项：

pip install -r requirements.txt

1. 创建一个 .env 项目根目录中的文件：

# Required - Base Ehiring Platform Key
BASE_API_KEY=your_base_api_key_here

# Optional - For enriched reviewer info (names/titles)
ACCOUNT_API_KEY=your_account_api_key

🎯 用法

运行服务器

# Debug/Dev mode
python server.py

# Production mode with FastMCP
fastmcp run server.py

服务器将在端口8000（HTTP传输）上启动。

📚 可用工具

看 tool_guide.md 了解详细的验证规则和场景。

1. get_job_description （拯救JD）

意图：当您需要了解角色要求、技能或福利时使用。 不要 使用此功能查找候选人。

• 输入: opening_name_or_id （可选）。

2. get_candidates_by_opening （列表和准备阅读）

意图：用于 广泛筛查。返回候选人列表。非常适合按日期过滤(start_date, end_date)或舞台(stage_name).

• 输入: opening_name_or_id （必填），过滤器。

3. get_candidate_details （详细信息和深度分析）

意图：用于 深入探究 分析。当你 *已有的* 考虑特定的候选人（ID或姓名），并需要他们的完整个人资料、简历文本和详细的评论。

• 输入: candidate_id 或(opening_name_or_id + candidate_name).

4. get_interviews_by_opening （时间表）

意图：用于检查 日历 或时间表。什么时候面试谁？

• 输入: date （特定日期）或范围。

5. get_offer_letter （报价）

意图：仅在 报价/成交 阶段检索报价文件。

• 输入: candidate_id OR ID/名称对。

📝 环境变量

🤝 贡献

此项目使用 快速MCP 用于其服务器实现。

• server.py：主要入口点。
• tool_guide.md：详细的工具文档。
• context.md：FastMCP上下文使用指南。