ClaudeのようなAIアシスタントがJobSpyツールを使って複数の求人リストプラットフォームで求人を検索できるようにするモデルコンテキストプロトコル(MCP)サーバーです。

特徴

• 複数のプラットフォーム(Indeed、LinkedIn、Glassdoorなど)で求人を検索
• 検索語、場所、時間枠などで絞り込み
• AIモデルが容易に処理できる構造化されたジョブデータの取得
• 結果をJSONまたはCSVとしてフォーマット
• 複数のトランスポートオプション:Claude統合用のstdio、ウェブクライアント向けのSSE

前提条件

• Node.js 16+
• Python 3.6+
• インストールされ利用可能なJobSpyツール

設置

構成

サーバーは自動的にJobSpyスクリプトを標準的な場所で探そうとします:

• ../jobSpy/run.sh(サーバーディレクトリに対して)
• ./run.sh(現在のディレクトリ内)
• /app/run.sh(Docker環境向け)

環境変数

以下の環境変数を使ってサーバーを設定できます:

JobSpy MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to search for jobs across multiple job listing platforms using the JobSpy tool.

Features

• Search for jobs across multiple platforms (Indeed, LinkedIn, Glassdoor, etc.)
• Filter by search terms, location, time frames, and more
• Get structured job data that AI models can easily process
• Format results as JSON or CSV
• Multiple transport options: stdio for Claude integration, SSE for web clients

Prerequisites

• Node.js 16+
• Python 3.6+
• The JobSpy tool installed and available

Installation

# Clone the repository
git clone https://github.com/borgius/jobspy-mcp-server.git
cd jobspy-mcp-server

# Install dependencies
npm install

# Make sure the JobSpy tool is properly set up
cd ../jobSpy
pip install -r requirements.txt
chmod +x run.sh

Configuration

The server will automatically try to locate the JobSpy script in standard locations:

• ../jobSpy/run.sh (relative to the server directory)
• ./run.sh (in the current directory)
• /app/run.sh (for Docker environments)

Environment Variables

You can configure the server using the following environment variables:

Setting Up Configuration

You can set these configuration values in multiple ways:

1. Using environment variables directly

export JOBSPY_DOCKER_IMAGE=jobspy
export JOBSPY_HOST='0.0.0.0'
export JOBSPY_PORT=9423
export ENABLE_SSE=1

2. Using a .env file

Create a .env file in the root directory with your configuration:

JOBSPY_DOCKER_IMAGE=jobspy
JOBSPY_HOST='0.0.0.0'
JOBSPY_PORT=9423
ENABLE_SSE=1

Usage

Starting the server

npm start

Connecting with Claude Desktop

Add the following to your Claude Desktop config file (typically at ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "jobspy": {
      "command": "node",
      "args": ["/path/to/jobspy-mcp-server/src/index.js"],
      "env": {
        "ENABLE_SSE": 0
      }
    }
  }
}

Using with Web Clients (SSE Transport)

The server exposes HTTP endpoints that allow web applications to interact with the JobSpy MCP server:

• Connect for updates: GET /mcp/connect
  • Establishes a Server-Sent Events (SSE) connection for real-time updates