基本能力
产品定位
HireBase MCP Server 是一个用于与 HireBase Job API 交互的工具,旨在提供职位搜索和候选人管理的功能。
核心功能
- 搜索职位:根据关键词、职位名称、地点、薪资等多种条件搜索职位。
- 参数包括:
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
。 - 获取职位详细信息:通过 HireBase ID 获取特定职位的详细信息。
- 参数包括:
job_id
。 - 创建候选人资料:根据候选人详细信息(姓名、LinkedIn、个人网站、简历文本)生成结构化提示,以帮助指导职位搜索。
- 参数包括:
name
,linkedin_url
,personal_website
,resume_text
。
适用场景
- 职位搜索:用户可以根据多种条件搜索职位,快速找到符合要求的职位。
- 候选人管理:通过生成候选人资料,帮助用户更好地管理候选人信息。
工具列表
search_jobs
:搜索职位。get_job
:获取职位详细信息。create_candidate_profile
:创建候选人资料。
常见问题解答
- 如何获取 HireBase API Key?
- 可以从 HireBase 申请 API Key。
- 如何设置环境变量?
- 可以通过设置
HIREBASE_API_KEY
环境变量来提供 API Key。
使用教程
使用依赖
- 确保
uv
已安装:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh - 获取 HireBase API Key(可选):
- 从 HireBase 申请 API Key,并设置为环境变量
HIREBASE_API_KEY
。
安装教程
- 使用
uvx
配置客户端: - Claude Desktop:编辑
claude_desktop_config.json
:
json
{
"mcpServers": {
"hirebase": {
"command": "uvx",
"args": [
"hirebase-mcp"
],
"env": {
"HIREBASE_API_KEY": ""
}
}
}
} -
Cursor:
- Mac/Linux 命令:
uvx hirebase-mcp
- Windows 命令:
cmd /c uvx hirebase-mcp
- 在适当部分设置
HIREBASE_API_KEY
环境变量。
- Mac/Linux 命令:
-
从源代码运行(替代方案):
- 克隆仓库并记录路径。
- 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"
]
}
}
}
调试方式
- 设置虚拟环境:
bash
uv venv - 安装依赖:
bash
uv pip install -e . - 运行测试:
bash
pytest