Job Finder MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Job Finder MCP Server
A Model Context Protocol (MCP) server built with Python that allows Claude Desktop to search for remote job listings using Playwright browser automation. The project is fully containerized with Docker for easy deployment and portability.
Features
Search remote jobs using Playwright
MCP server compatible with Claude Desktop
Dockerized for easy deployment
Uses Groq API for intelligent processing
Supports environment variables for secure API key management
Related MCP server: JobPilot MCP
Tech Stack
Python 3.12
Model Context Protocol (MCP)
Playwright
Docker
Claude Desktop
Groq API
Project Structure
Job_Finder_mcp_docker/
│
├── mcp_job.py # MCP server implementation
├── Dockerfile # Docker configuration
├── requirements.txt # Python dependencies
├── .gitignore
└── README.mdInstallation
1. Clone the repository
git clone https://github.com/Zakria774/Job_Finder_mcp_docker.git
cd Job_Finder_mcp_docker2. Create a virtual environment
python3 -m venv .venv
source .venv/bin/activate3. Install dependencies
pip install -r requirements.txt
playwright install chromium4. Create a .env file
Create a file named .env
GROQ_API_KEY=your_groq_api_keyDo not upload your
.envfile to GitHub.
Running Locally
Start the MCP server:
python mcp_job.pyThe server will wait for requests from an MCP client such as Claude Desktop.
Running with Docker
Build the Docker image:
docker build -t job_finder .Run the Docker container:
docker run -i --rm job_finderClaude Desktop Configuration
Add the following configuration to your claude_desktop_config.json:
{
"mcpServers": {
"job_finder": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"job_finder"
]
}
}
}Restart Claude Desktop after saving the configuration.
Example Prompt
Find me remote Python jobs using my job finder tool.Claude Desktop will invoke the MCP server and return job listings.
Environment Variables
Variable | Description |
GROQ_API_KEY | Your Groq API key |
Security
Ensure your .gitignore includes:
.env
.venv/
__pycache__/
*.pycNever commit API keys or secrets to GitHub.
Author
Muhammad Zakria
GitHub: https://github.com/Zakria774
License
This project is open source and available under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search remote jobs, read full postings, and get application links from Claude, Codex, Cursor, and other compatible MCP clients. Tools: search_jobs, get_job, get_filters. Supports cursor pagination and location, category, skill, seniority, employment type, and salary availability filters. Free, read-only Streamable HTTP; no account or API key required. Posting-based facts; remote does not imply worldwide eligibility. Setup: https://heyrole.ai/developers
Search remote tech jobs, inspect descriptions, compare roles, and retrieve application links.
Remote job boards, LinkedIn jobs, company ATS pages and Upwork jobs as tools. Runs on Apify.
Remote jobs (RemoteOK, Remotive, WWR, HN) and career pages on Greenhouse, Lever, Workday.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables job search and scraping across multiple job boards (LinkedIn, Indeed, Glassdoor, etc.) with advanced filtering, directly from Claude Desktop or other MCP clients.6MIT
- AlicenseAqualityDmaintenanceTransforms Claude into an AI job-hunting assistant that searches remote job boards, scores roles against your CV, generates tailored cover letters, and logs everything to a Notion tracker.11MIT
- FlicenseNot gradedqualityDmaintenanceAutomates LinkedIn job search and Easy Apply using Playwright and Claude Code, with tools for login, job search, form filling, and batch applications.-
- AlicenseNot gradedqualityCmaintenanceEnables users to search and browse remote tech jobs from RemoteOK job board through natural language queries, with no API key required.94 npmMIT