Hirebase Mcp

🚀 HireBase MCP 服务器

HireBase MCP 服务器是一款提供与 HireBase 工作 API 相互作用工具的 Model Context Protocol (MCP) 服务器，能帮助用户基于各种标准搜索工作、获取特定工作详细信息以及生成结构化提示等。

🚀 快速开始

本服务器提供了一系列 MCP 交互，可用于与 HireBase 工作 API 进行交互。若要与像 Claude Desktop 或 Cursor 这样的 MCP 客户端一起使用此服务器，请按以下步骤配置客户端以运行服务器进程，并可选地提供 HireBase API 密钥。

✨ 主要特性

此服务器提供了以下 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）

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

💻 使用示例

基础用法

以下是使用 search_jobs 工具搜索工作的示例：

# 假设我们有一个函数可以调用 MCP 交互
# 这里只是示例，实际代码需要根据具体实现来编写
from mcp_client import call_mcp_interaction

# 定义参数
params = {
"query": "python developer",
"country": "USA",
"limit": 10
}

# 调用 search_jobs 交互
result = call_mcp_interaction("search_jobs", params)
print(result)

高级用法

以下是结合 create_candidate_profile 生成提示并使用 search_jobs 搜索工作的示例：

from mcp_client import call_mcp_interaction

# 生成候选人提示
candidate_params = {
"name": "John Doe",
"linkedin_url": "https://www.linkedin.com/in/johndoe",
"resume_text": "Python developer with 5 years of experience..."
}
prompt = call_mcp_interaction("create_candidate_profile", candidate_params)

# 使用提示进行工作搜索
search_params = {
"query": prompt,
"country": "USA",
"limit": 10
}
result = call_mcp_interaction("search_jobs", search_params)
print(result)

🔧 技术细节

该项目使用了以下工具和技术：

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