JobSpy MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 AI 助手（如Claude）能够搜索多个工作招聘平台上的职位，使用 JobSpy 工具。

特性

• 在 Indeed、LinkedIn、Glassdoor 等多个平台上搜索职位
• 根据关键词、地点和时间筛选职位信息
• 返回结构化的数据供 AI 处理
• 支持 JSON 和 CSV 格式的输出结果

先决条件

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

安装步骤

# 克隆仓库
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

注意： 请确保在翻译过程中，技术术语和代码示例保持不变，以保证准确性和可操作性。