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

⚠️ 重要提示

请确保在使用过程中，严格按照文档说明进行操作，以保证服务器的正常运行。同时，在翻译过程中，技术术语和代码示例保持不变，以保证准确性和可操作性。