HireBase MCP 服务器

模型上下文协议 (MCP) 服务器提供与 HireBase Job API 交互的工具。

可用的 MCP 相互作用

该服务器公开以下 MCP 交互：

工具

• search_jobs ：使用 HireBase 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 。
• get_job ：使用 HireBase ID 检索有关特定工作的详细信息。
  • 参数： job_id 。

提示

• create_candidate_profile ：根据候选人详细信息（姓名、LinkedIn、网站、简历文本）生成结构化提示，以帮助指导求职。
  • 参数： name 、 linkedin_url 、 personal_website 、 resume_text 。

客户端设置（示例：Claude Desktop、Cursor）

要将此服务器与 Claude Desktop 或 Cursor 等 MCP 客户端一起使用，您需要配置客户端以运行服务器进程并选择性地提供 HireBase API 密钥。

1. 确保已安装uv ： curl -LsSf https://astral.sh/uv/install.sh | sh
2. **获取 HireBase API 密钥（可选）：**从HireBase请求密钥您可以将其设置为环境变量（ HIREBASE_API_KEY ）或将其留空。
3. 配置您的客户端：
   • 使用uvx ：
     • **Claude Desktop：**编辑您的claude_desktop_config.json ：
       { "mcpServers": { "hirebase": { "command": "uvx", "args": [ "hirebase-mcp" ], "env": { "HIREBASE_API_KEY": "" } } } }
     • **光标：**转到设置 > MCP > 添加服务器：
       • Mac/Linux 命令： uvx hirebase-mcp （如有需要，调整包名称）
       • Windows 命令： cmd
       • Windows 参数： /c 、 uvx 、 hirebase-mcp （如果需要，调整包名称）
       • 在适当的部分设置HIREBASE_API_KEY环境变量。
   • 通过 Python 从源代码运行（替代方法）：
     1. 克隆 repo 并记下克隆到的位置
     2. **Claude Desktop：**编辑您的claude_desktop_config.json ：GXP2

发展

该项目使用：

• uv用于依赖管理和虚拟环境
• 用于 linting 和格式化的ruff
• hatch构建后端

常见任务

环境变量

• HIREBASE_API_KEY （必需）：用于访问 HireBase API 的 API 密钥。服务器需要此密钥才能发出经过身份验证的职位数据请求。

测试

该项目使用pytest测试核心工具逻辑。测试使用unittest.mock模拟外部 API 调用。

1. 安装测试依赖项：

2. 运行测试：

贡献

欢迎投稿。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。