Movie Search MCP Server

Implementation Reference

• src/index.ts:246-295 (registration)

  Registration of the 'popular_movies' tool. Includes empty input schema {} and the inline handler function that calls getTrendingMovies() to fetch data and formats a markdown response.

  server.tool("popular_movies", {}, async () => {
    try {
      const popular = await getTrendingMovies();
  
      if (popular.length === 0) {
        return {
          content: [
            {
              type: "text",
              text: "❌ Could not get popular movies at this time.",
            },
          ],
        };
      }
  
      let response = "🔥 **Most popular movies this week:**\n\n";
  
      popular.forEach((movie, index) => {
        response += `${index + 1}. **${movie.title}** (${movie.year})\n`;
        response += `   - TMDb ID: ${movie.id}\n`;
        if (movie.poster !== "N/A") {
          response += `   - Poster: ${movie.poster}\n`;
        }
        response += "\n";
      });
  
      response +=
        '\n💡 *Use "get_movie_details" with the ID and source "tmdb" for more information.*';
  
      return {
        content: [
          {
            type: "text",
            text: response,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `❌ Error getting popular movies: ${
              error instanceof Error ? error.message : "Unknown error"
            }`,
          },
        ],
      };
    }
  });

• src/movie-apis.ts:304-334 (helper)

  Helper function getTrendingMovies() that implements the core logic: fetches weekly trending movies from TMDb /trending/movie/week endpoint, maps to SearchResult objects (title, year, id, poster, source).

  export async function getTrendingMovies(): Promise<SearchResult[]> {
    if (!TMDB_API_KEY) {
      return [];
    }
  
    try {
      const params = new URLSearchParams({
        api_key: TMDB_API_KEY,
        language: "en-US",
      });
  
      const response = await fetch(
        `${TMDB_BASE_URL}/trending/movie/week?${params}`
      );
      const data = (await response.json()) as TMDbSearchResult;
  
      return data.results.slice(0, 15).map((movie) => ({
        title: movie.title,
        year: movie.release_date ? movie.release_date.split("-")[0] : "",
        id: movie.id.toString(),
        type: "movie",
        poster: movie.poster_path
          ? `https://image.tmdb.org/t/p/w500${movie.poster_path}`
          : "N/A",
        source: "tmdb" as const,
      }));
    } catch (error) {
      console.error("Error getting trending movies:", error);
      return [];
    }
  }

• src/types.ts:120-127 (schema)

  TypeScript interface SearchResult used by getTrendingMovies to type the output array of movie search results.

  export interface SearchResult {
    title: string;
    year: string;
    id: string;
    type: string;
    poster: string;
    source: "omdb" | "tmdb";
  }