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:

pip install -r requirements.txt

Usage

Running the MCP Server

The server can be run directly:

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):

{
  "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:

{
  "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