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 。

Related MCP server: JobDataLake MCP Server

客户端设置（示例：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构建后端

常见任务

# 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文件。