Job Search MCP Server

An MCP server that lets an MCP-compatible assistant search public job listings. It currently uses EURES and does not require an API key.

Setup

Requires Python 3.11+ and uv.

uv sync
uv run pytest

Run

Run the server directly over stdio:

uv run job-search-mcp

Docker

Build and run the public Streamable HTTP server. It listens on port 8000 and allows 60 requests per IP per 60 seconds by default.

docker build -t job-search-mcp .
docker run --rm -p 8000:8000 job-search-mcp

The MCP endpoint is http://localhost:8000/mcp. Adjust the limiter with RATE_LIMIT_REQUESTS and RATE_LIMIT_WINDOW. This limiter is in-memory and is intended for one container instance; use a proxy or shared store when scaling.

For Claude Desktop, add this entry to its MCP configuration:

{
  "mcpServers": {
    "job-search": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/jobfinder", "run", "job-search-mcp"]
    }
  }
}

Tools

• search_jobs: filter by keywords, location, remote-only status, and result limit.
• job_search_sources: see provider and credential information.

Search results include title, company, location, remote status, description, tags, and a direct listing URL. Listings come from a third-party provider and should be checked before applying.