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