Movie Search MCP Server

Implementation Reference

• src/index.ts:300-345 (registration)

  Registration of the 'movie_help' tool with an inline anonymous handler function that returns a comprehensive markdown-formatted help text describing all available MCP tools, required API keys, and usage examples.

  server.tool("movie_help", {}, async () => {
    const help = `
  🎬 **Movie Search MCP Server** 🎬
  
  **Available tools:**
  
  1. **search_movies** - Search movies by title
     - \`title\`: Movie title (required)
     - \`year\`: Movie year (optional)
  
  2. **get_movie_details** - Get complete movie information
     - \`id\`: Movie ID (IMDB ID or TMDb ID)
     - \`source\`: 'omdb' or 'tmdb' (default: omdb)
  
  3. **recommend_movies** - Get movie recommendations
     - \`genre\`: Specific genre (optional)
     - Available genres: action, adventure, animation, comedy, crime, documentary, drama, family, fantasy, history, horror, music, mystery, romance, science fiction, thriller, war, western
  
  4. **popular_movies** - Get the most popular movies of the week
  
  5. **movie_help** - Show this help
  
  **APIs used:**
  - 🎭 **OMDb API**: For detailed IMDB information
  - 🎬 **TMDb API**: For advanced searches and recommendations
  
  **Required configuration:**
  - Environment variable \`OMDB_API_KEY\` (get at: http://www.omdbapi.com/apikey.aspx)
  - Environment variable \`TMDB_API_KEY\` (get at: https://www.themoviedb.org/settings/api)
  
  **Usage examples:**
  - "Search for Batman movies"
  - "Get details for movie tt0468569"
  - "Recommend action movies"
  - "What are the popular movies?"
  `;
  
    return {
      content: [
        {
          type: "text",
          text: help,
        },
      ],
    };
  });

• src/index.ts:300-345 (handler)

  The inline handler for the movie_help tool, which constructs and returns a structured content response containing help documentation for the Movie MCP server.

  server.tool("movie_help", {}, async () => {
    const help = `
  🎬 **Movie Search MCP Server** 🎬
  
  **Available tools:**
  
  1. **search_movies** - Search movies by title
     - \`title\`: Movie title (required)
     - \`year\`: Movie year (optional)
  
  2. **get_movie_details** - Get complete movie information
     - \`id\`: Movie ID (IMDB ID or TMDb ID)
     - \`source\`: 'omdb' or 'tmdb' (default: omdb)
  
  3. **recommend_movies** - Get movie recommendations
     - \`genre\`: Specific genre (optional)
     - Available genres: action, adventure, animation, comedy, crime, documentary, drama, family, fantasy, history, horror, music, mystery, romance, science fiction, thriller, war, western
  
  4. **popular_movies** - Get the most popular movies of the week
  
  5. **movie_help** - Show this help
  
  **APIs used:**
  - 🎭 **OMDb API**: For detailed IMDB information
  - 🎬 **TMDb API**: For advanced searches and recommendations
  
  **Required configuration:**
  - Environment variable \`OMDB_API_KEY\` (get at: http://www.omdbapi.com/apikey.aspx)
  - Environment variable \`TMDB_API_KEY\` (get at: https://www.themoviedb.org/settings/api)
  
  **Usage examples:**
  - "Search for Batman movies"
  - "Get details for movie tt0468569"
  - "Recommend action movies"
  - "What are the popular movies?"
  `;
  
    return {
      content: [
        {
          type: "text",
          text: help,
        },
      ],
    };
  });