职位搜索服务

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：根据候选人详细信息（姓名、领英、网站、简历文本）生成结构化提示，以帮助指导求职。
  • 参数: name, linkedin_url, personal_website, resume_text.

客户端设置（示例：Claude桌面、光标）

要将此服务器与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_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. 克隆仓库并记下克隆到的位置
     2. 克劳德桌面： 编辑您的 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 用于测试核心工具逻辑。使用测试模拟外部API调用 unittest.mock.

1. 安装测试依赖项：

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

2. 运行测试：

# Example command
pytest

贡献

欢迎捐款。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。