Content
# 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
