HireBase MCP Server

基本能力

产品定位

HireBase MCP Server 是一个用于与 HireBase Job API 交互的工具，旨在提供职位搜索和候选人管理的功能。

核心功能

1. 搜索职位：根据关键词、职位名称、地点、薪资等多种条件搜索职位。
2. 参数包括：query, and_keywords, or_keywords, not_keywords, title, category, country, city, location_type, company, salary_from, salary_to, salary_currency, years_from, years_to, visa, limit。
3. 获取职位详细信息：通过 HireBase ID 获取特定职位的详细信息。
4. 参数包括：job_id。
5. 创建候选人资料：根据候选人详细信息（姓名、LinkedIn、个人网站、简历文本）生成结构化提示，以帮助指导职位搜索。
6. 参数包括：name, linkedin_url, personal_website, resume_text。

适用场景

1. 职位搜索：用户可以根据多种条件搜索职位，快速找到符合要求的职位。
2. 候选人管理：通过生成候选人资料，帮助用户更好地管理候选人信息。

工具列表

1. search_jobs：搜索职位。
2. get_job：获取职位详细信息。
3. create_candidate_profile：创建候选人资料。

常见问题解答

1. 如何获取 HireBase API Key？
2. 可以从 HireBase 申请 API Key。
3. 如何设置环境变量？
4. 可以通过设置 HIREBASE_API_KEY 环境变量来提供 API Key。

使用教程

使用依赖

1. 确保 uv 已安装： bash curl -LsSf https://astral.sh/uv/install.sh | sh
2. 获取 HireBase API Key（可选）：
3. 从 HireBase 申请 API Key，并设置为环境变量 HIREBASE_API_KEY。

安装教程

1. 使用 uvx 配置客户端：
2. Claude Desktop：编辑 claude_desktop_config.json： json { "mcpServers": { "hirebase": { "command": "uvx", "args": [ "hirebase-mcp" ], "env": { "HIREBASE_API_KEY": "" } } } }

3. Cursor：

   • Mac/Linux 命令：uvx hirebase-mcp
   • Windows 命令：cmd /c uvx hirebase-mcp
   • 在适当部分设置 HIREBASE_API_KEY 环境变量。

4. 从源代码运行（替代方案）：

5. 克隆仓库并记录路径。
6. Claude Desktop：编辑 claude_desktop_config.json： json { "mcpServers": { "hirebase": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "--with", "requests", "mcp", "run", "PATH_TO_REPO/src/hirebase_mcp/server.py" ] } } }

调试方式

1. 设置虚拟环境： bash uv venv
2. 安装依赖： bash uv pip install -e .
3. 运行测试： bash pytest

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。