HireBase MCP 服务器

一个提供与 HireBase 工作 API 相互作用工具的 Model Context Protocol (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）

要与像 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": [
               "hfirebase-mcp" 
             ],
             "env": {
               "HIREBASE_API_KEY": "" 
             }
           }
         }
       }
       

     • Cursor: 转到设置 > MCP > 添加服务器:
       • Mac/Linux 命令: uvx hirebase-mcp（根据需要调整包名）
       • Windows 命令: cmd
       • Windows Args: /c, uvx, hfirebase-mcp（根据需要调整包名）
       • 在适当的区域设置 HIREBASE_API_KEY 环境变量。

   • 从源代码运行（替代方法）:

     1. 克隆仓库并注意您克隆的位置
     2. Claude Desktop: 编辑您的 claude_desktop_config.json：

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

开发

该项目使用：

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

常见任务

# 设置虚拟环境
uv venv

# 安装依赖项
uv pip install -e .

# 安装 CLI 工具
uv tool install ruff

# 运行代码检查
ruff 检查 .

# 格式化代码
ruff 格式化 .

环境变量

• HIREBASE_API_KEY: 用于与 HireBase API 授权的密钥。

测试

要测试 MCP 服务器，请运行以下命令：

uv run --with mcp[cli] --with requests mcp 运行

贡献

要贡献代码或提出问题，请访问 GitHub 仓库.

许可证

此项目受 MIT 许可证保护。有关详细信息，请参阅 LICENSE 文件。