HireBase MCP 服务器

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

可用的 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）

要使用此服务器与 MCP 客户端（如 Claude Desktop 或 Cursor）配合，请需要配置客户端以运行服务器进程，并可选地提供 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": "" 
             }
           }
         }
       }
       

     • Cursor： 前往设置 > MCP > 添加服务器：
       • Mac/Linux 命令： uvx hibernate-mcp（如有需要调整包名）
       • Windows 命令： cmd
       • Windows 参数： /c，uvx，hirebase-mcp（如有需要调整包名）
       • 在适当的部分设置 HIREBASE_API_KEY 环境变量。

   • 通过 Python 从源代码运行（备选方案）：

     1. 克隆仓库并记下克隆的位置
     2. Claude Desktop： 编辑您的 claude_desktop_config.json：

     {
         "mcpServers": {
             "hirebase": {
                 "command": "uv",
                 "args": [
                     "run",
                     "--with",
                     "mcp[cli]",
                     "--with",
                     "requests",
                     "mcp",
                     "run",
                     "PATH_TO_REPO/src/hirebase_mcp/server.py"
                 ]
             }
         }
     }
     

开发

本项目使用：

• uv 进行依赖管理和虚拟环境管理
• ruff 进行代码检查和格式化
• hatch 作为构建后端

常见任务

# 设置虚拟环境
uv venv

# 安装依赖
uv pip install -e .

# 安装 CLI 工具
uv tool install ruff

# 运行代码检查
ruff check .

# 格式化代码
ruff format .

环境变量

• HIREBASE_API_KEY（必需）：用于访问 HireBase API 的 API 密钥。服务器需要此密钥才能进行认证请求以获取职位数据。

测试

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

1. 安装测试依赖：

# 确保您处于激活的虚拟环境中 (.venv)
uv pip install -e '.[test]'

2. 运行测试：

# 示例命令
pytest

贡献

欢迎贡献。

许可

本项目采用 MIT 许可证 - 详见 LICENSE 文件。