HireBase MCP Server

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": "" 
             }
           }
         }
       }
       

     • Cursor： 前往 Settings > MCP > Add Server：
       • Mac/Linux 命令： uvx hirebase-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 作为构建后端

常见任务

# Setup virtual env
uv venv

# Install dependencies
uv pip install -e .

# install cli tools
uv tool install ruff

# Run linting
ruff check .

# Format code
ruff format .

环境变量

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

测试

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

1. 安装测试依赖：

# Ensure you are in your activated virtual environment (.venv)
uv pip install -e '.[test]'

2. 运行测试：

# Example command
pytest

贡献

欢迎贡献。

许可证

此项目采用 MIT 许可证，详情请参阅 LICENSE 文件。