# job-mcp
## Job Search MCP Server

A simple **MCP server** that allows Claude to search for developer jobs and provide job application links.

## Features

* Search frontend developer jobs
* Search React jobs
* Search Vue.js jobs
* Search Angular jobs
* Search TypeScript jobs
* Search Next.js jobs
* Get job application links
* Uses Python
* Uses SQLite for local job data

## How it Works: 
```bash
User
  |
  v
Claude
  |
  v
MCP Server
  |
  v
Job Search
  |
  v
SQLite Database
  |
  v
Matching Jobs
  |
  v
Job Details + Application Link
```

## Example Prompts

### Basic

```text
Find frontend developer jobs
```

```text
Search for frontend jobs
```

```text
Show me remote frontend developer roles
```

### Skill-Specific

```text
Find React developer jobs
```

```text
Search for Vue.js positions
```

```text
Show me Angular developer jobs
```

```text
Find TypeScript frontend roles
```

```text
Search for Next.js developer jobs
```

## Example Result

```text
Frontend Engineer - React and AWS

https://jobicy.com/jobs/145744-frontend-engineer-react-and-aws
```

## Tech Stack

* Python
* MCP
* SQLite
* Claude Desktop

## Project Structure

```text
job-mcp/
│
├── server.py
├── providers.py
├── database.py
├── requirements.txt
├── jobs.db
└── README.md
```

## Installation

Clone the repository:
```code
git clone https://github.com/Pradesha3112/job-mcp.git
```
Go to the project folder:
``` code
cd job-mcp
```
Create a virtual environment:
```code
python -m venv .venv
```
Activate the virtual environment on Windows:
```bash
.venv\Scripts\activate
```
## Install the required packages:
```bash
pip install -r requirements.txt
```
Run the MCP Server

### Start the server using:

```bash
python server.py
```
The server is designed to communicate with Claude through MCP.

## Author

**Pradesha3112**

GitHub: `https://github.com/Pradesha3112`

## Screenshots:
<img width="1366" height="768" alt="image" src="https://github.com/user-attachments/assets/a0fbbf9b-66c7-4b52-b380-16a0193f5cba" />
<img width="1366" height="768" alt="image" src="https://github.com/user-attachments/assets/1218f6e4-585c-4f3d-9587-b005cb2ad6e7" />
<img width="1366" height="768" alt="image" src="https://github.com/user-attachments/assets/9888eeac-de41-46f8-8aa6-1109ec391ad7" />
<img width="1366" height="768" alt="image" src="https://github.com/user-attachments/assets/c732f4b9-8699-4406-bae5-6099605b9117" />