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

---

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.md

---

Installation

1. Clone the repository

git clone https://github.com/Zakria774/Job_Finder_mcp_docker.git
cd Job_Finder_mcp_docker

2. Create a virtual environment

python3 -m venv .venv
source .venv/bin/activate

3. Install dependencies

pip install -r requirements.txt
playwright install chromium

4. Create a .env file

Create a file named .env

GROQ_API_KEY=your_groq_api_key

Do not upload your .env file to GitHub.

---

Running Locally

Start the MCP server:

python mcp_job.py

The 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_finder

---

Claude 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__/
*.pyc

Never 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.