omdb-mcp-server

Overview

The OMDB MCP Server is a production-ready implementation built with Spring Boot and Spring AI, providing access to the Open Movie Database through MCP protocol. It features intelligent caching, comprehensive tool coverage, and modern architecture with reactive programming. The server implements MCP 2024-11-05 specification with HTTP JSON-RPC transport, offering tools for movie search, detail retrieval, and movie lookup by IMDB ID.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• search_movies

  Search for movies by title in the OMDB database

  Try:Find movies with the title InceptionTry:Search for Star Wars movies from 1977Try:Look for comedy movies starring Tom Hanks
• get_movie_details

  Retrieve detailed information about a specific movie by title

  Try:Get details about the movie The MatrixTry:Show me information for the movie Pulp FictionTry:Fetch details for the movie Avatar
• get_movie_by_imdb_id

  Get detailed information about a movie using its IMDB ID

  Try:Find movie with IMDB ID tt0133093Try:Get details for IMDB ID tt0468569Try:Fetch information using IMDB ID tt9362722

Comparable tools

Installation

docker run -p 8081:8081 -e OMDB_API_KEY=your-api-key ghcr.io/tyrell/omdb-mcp-server:latest

java -jar omdb-mcp-server-*.jar --omdb.api.key=your-api-key

git clone https://github.com/tyrell/omdb-mcp-server
cd omdb-mcp-server
./mvnw clean package
export OMDB_API_KEY=your-api-key
./mvnw spring-boot:run

{
  "mcpServers": {
    "omdb": {
      "command": "docker",
      "args": ["run", "--rm", "-p", "8081:8081", "-e", "OMDB_API_KEY=your-api-key", "ghcr.io/tyrell/omdb-mcp-server:latest"]
    }
  }
}

FAQ

What OMDB API tools are available?

The server provides three main tools: search_movies (search by title/year/type), get_movie_details (retrieve details by title), and get_movie_by_imdb_id (get details using IMDB ID).

How is caching implemented?

The server uses Caffeine in-memory caching with a default TTL of 1 hour and a maximum of 1000 entries with LRU eviction policy. Cache statistics can be accessed via /cache/stats endpoint.

Compare omdb-mcp-server with