JobSpy MCP Server

An implementation of the Model Context Protocol (MCP) that integrates the python-jobspy library. This server allows AI models like Claude to perform real-time, aggregated job searches across LinkedIn, Indeed, ZipRecruiter, and Glassdoor directly from the chat interface.

Features

• Aggregated Search: Query multiple job boards simultaneously with a single command.
• Advanced Filtering: Support for job_type (contract, full-time, etc.), is_remote, and distance.
• Intelligent Salary Filter: A local processing layer that filters results to only show jobs meeting your min_salary requirement.
• Markdown Summaries: Use the jobs://latest-summary resource to view your most recent search results in a clean, human-readable table.
• JSON Serialization Fix: Properly handles Python date objects to prevent "Object of type date is not JSON serializable" errors.

Installation

1. Clone the Repository

git clone [https://github.com/YOUR_USERNAME/jobspy_mcp_server.git](https://github.com/YOUR_USERNAME/jobspy_mcp_server.git)
cd jobspy_mcp_server

2. Install Dependencies

Ensure you are using Python 3.10 or higher.

pip install mcp python-jobspy pandas tabulate

Configuration for Claude Desktop

To use this server, add it to your claude_desktop_config.json.

File Locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Config Entry:

{
  "mcpServers": {
    "jobspy-pro": {
      "command": "python",
      "args": ["/home/lowcoordination/DataspellProjects/jobspy_mcp_server/job_server.py"]
    }
  }
}

(Note: Ensure the absolute path in the args section matches your local environment.)

Usage

Once the server is connected (look for the 🔌 icon in Claude), you can use prompts like:

• "Find me remote Information Security GRC roles paying at least $130,000."
• "Search for 6-month contracts for Cybersecurity Engineers near Indianapolis."
• "What are the latest job postings for IT Security Consultants in the last 24 hours?"

License

This project is licensed under the MIT License. It is a wrapper designed for the Model Context Protocol and utilizes the MIT-licensed python-jobspy library.