# Tamilrockers MCP Server

An MCP (Model Context Protocol) server that searches for movies and series on the Tamilrockers website and returns movie links.

## Features

- Search for movies and series by name
- Returns movie links, titles, years, and poster URLs
- SQLite database caching for faster subsequent searches
- Supports both movies and series

## Installation

1. Install Python dependencies:
```bash
pip install -r requirements.txt
```

## Usage

### Running the MCP Server

The server can be run directly:
```bash
python mcp_server.py
```

### MCP Configuration

To use this server with Cursor or other MCP clients, add it to your MCP configuration file (typically `~/.cursor/mcp.json` or similar):

```json
{
  "mcpServers": {
    "tamilrockers-search": {
      "command": "python",
      "args": ["C:\\Users\\yashwanthkumar05\\Desktop\\rocker\\mcp_server.py"]
    }
  }
}
```

### Available Tools

#### `search_movie`

Searches for a movie or series on Tamilrockers.

**Parameters:**
- `movie_name` (string, required): The name of the movie or series to search for

**Returns:**
```json
{
  "query": "movie name",
  "count": 1,
  "results": [
    {
      "name": "Movie Title",
      "link": "https://tamilrockers.gen.in/movie/123456-movie-title",
      "type": "movie",
      "year": "2026",
      "poster": "https://poster.tamilrockers.gen.in/movie/movie-title.webp"
    }
  ]
}
```

## Database

The server uses SQLite to cache search results in `tamilrockers_cache.db`. This improves performance for repeated searches and reduces load on the Tamilrockers website.

## Notes

- The server respects the website's structure and extracts information from the movie grid
- Results are cached in SQLite for faster retrieval
- The server handles both movies (`/movie/`) and series (`/series/`) links
- Search is case-insensitive and supports partial matches