Jobspy MCP Server

🚀 JobSpy MCP 服務器

JobSpy MCP 服務器是一個模型上下文協議 (MCP) 服務器，藉助 JobSpy 工具，讓 AI 助手（如Claude）能夠在多個工作招聘平臺上搜索職位，為 AI 處理提供便利。

🚀 快速開始

在使用 JobSpy MCP 服務器之前，請確保滿足以下先決條件：

• Node.js 16 或更高版本
• Python 3.6 或更高版本
• 已安裝的 JobSpy 工具

✨ 主要特性

• 可在 Indeed、LinkedIn、Glassdoor 等多個平臺上搜索職位。
• 能根據關鍵詞、地點和時間篩選職位信息。
• 返回結構化的數據，方便 AI 進行處理。
• 支持 JSON 和 CSV 格式的輸出結果。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/yourusername/jobspy-mcp-server.git
cd jobspy-mcp-server

# 安裝依賴項
npm install

# 設置 JobSpy 環境
pip install jobspy

📚 詳細文檔

配置

服務器會自動查找 JobSpy 腳本的位置，並通過以下環境變量進行配置：

設置方法

1. 直接使用命令行

export JOBSPY_DOCKER_IMAGE=jobspy-mcp-server:latest
export JOBSPY_ACCESS_TOKEN=your_access_token

2. 創建 .env 文件 在項目根目錄下創建一個 .env 文件，添加以下內容：

JOBSPY_DOCKER_IMAGE=jobspy-mcp-server:latest
JOBSPY_ACCESS_TOKEN=your_access_token

使用方法

啟動服務器

npm start

與 Claude Desktop 集成

在配置文件中添加以下內容，以支持與 Claude 的集成：

{
  "claude": {
    "enabled": true,
    "apiKey": "your_claude_api_key"
  }
}

SSE 傳輸支持

服務器提供了即時流式處理功能。以下是連接示例代碼：

const eventSource = new EventSource('http://localhost:9423/sse');

eventSource.addEventListener('message', function(e) {
    console.log('數據:', e.data);
});

API 接口

搜索職位

curl -X POST "http://localhost:9423/api" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "search_jobs",
    "params": {
      "search_term": "軟件工程師",
      "location": "加利福尼亞州聖弗朗西斯科",
      "site_names": "indeed,linkedin",
      "results_wanted": 10,
      "format": "json"
    }
  }'

可用工具

搜索職位（search_jobs）

參數說明

示例用法

我需要查找波士頓的高級軟件工程師職位，且在 24 小時內發佈。

Docker 支持

構建鏡像

docker build -t jobspy-mcp-server .

運行容器

docker run -p 9423:9423 jobspy-mcp-server

開發環境

開發模式運行

npm run dev

執行測試

npm test

⚠️ 重要提示

請確保在使用過程中，嚴格按照文檔說明進行操作，以保證服務器的正常運行。同時，在翻譯過程中，技術術語和代碼示例保持不變，以保證準確性和可操作性。