# MCP Technopark Job Search

A Model Context Protocol (MCP) server that provides job search functionality for Technopark (technopark.in). This server enables AI assistants to search and retrieve job listings from Technopark's job portal.

## Features

- 🔍 Search jobs by role/title keywords
- 📊 Retrieve job details including title, company, closing date, and posted date
- 🤖 MCP-compatible server for seamless integration with AI assistants
- 🕷️ Web scraping using Puppeteer for real-time data
- 📝 TypeScript implementation with type safety

## Installation

1. Clone the repository:

```bash
git clone https://github.com/vinothvino42/mcp-technopark-job-search.git
cd mcp-technopark-job-search
```

2. Install dependencies:

```bash
npm install
```

3. Build the project:

```bash
npm run build
```

## Usage

### Development Mode

Run the server in development mode with hot reloading:

```bash
npm run dev
```

### Production Mode

Build and run the server:

```bash
npm run build
node build/index.js
```

### MCP Inspector

Debug and test the server using the MCP Inspector:

```bash
npm run inspect
```

## MCP Server Configuration

To use this server with an MCP-compatible client, add it to your MCP configuration:

```json
{
  "mcpServers": {
    "technopark-job-search": {
      "command": "node",
      "args": ["path/to/mcp-technopark-job-search/build/index.js"]
    }
  }
}
```

## Tools

The server provides the following tool:

### `technopark-job-search`

Search for jobs on Technopark by role or keyword.

**Parameters:**

- `role` (string, required): The job role or keyword to search for

**Response format:**

```json
[
  {
    "title": "Software Engineer",
    "company": "TechCorp Solutions",
    "closingDate": "2025-08-15",
    "postedDate": "2025-07-20"
  }
]
```

## License

This project is licensed under the ISC License.

## Author

**Vinoth**

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.