wizzy-mcp-tmdb

Instructions

Implementation Reference

• mcp-tmdb-server.js:175-178 (handler)

  The handler function that implements the core logic of the movie_reviews tool by fetching user reviews from the TMDB API endpoint `/movie/{movie_id}/reviews` and returning the paginated JSON results as MCP-formatted text content.

  handler: async ({movie_id, language, page, region}) => {
      const data = await tmdbFetch(`/movie/${movie_id}/reviews`, {language, page, region});
      return {content: [{type: "text", text: JSON.stringify(data, null, 2)}]};
  }

• mcp-tmdb-server.js:164-174 (schema)

  The inputSchema defining the expected parameters and validation rules for the movie_reviews tool, including required movie_id and optional language, page, and region.

  inputSchema: {
      type: "object",
      properties: {
          movie_id: {type: "number", description: "TMDB Movie ID"},
          language: {type: "string", description: "ISO 639-1 code (e.g., en-US)"},
          page: {type: "number", minimum: 1, description: "Page number"},
          region: {type: "string", description: "ISO 3166-1 region code (e.g., US)"}
      },
      required: ["movie_id"],
      additionalProperties: false
  },

• mcp-tmdb-server.js:18-38 (helper)

  The tmdbFetch helper utility function used by the movie_reviews handler (and other tools) to make authenticated API requests to the TMDB proxy service.

  async function tmdbFetch(path, params = {}) {
      if (!TMDB_AUTH_TOKEN) {
          throw new Error("TMDB authorization token is not configured");
      }
      const url = new URL(TMDB_BASE + path);
      Object.entries(params).forEach(([k, v]) => {
          if (v !== undefined && v !== null && v !== "") url.searchParams.set(k, String(v));
      });
  
      const res = await fetch(url, {
          headers: {
              Accept: "application/json",
              Authorization: TMDB_AUTH_TOKEN,
          },
      });
      if (!res.ok) {
          const text = await res.text().catch(() => "");
          throw new Error(`TMDB request failed ${res.status}: ${text}`);
      }
      return res.json();
  }

• mcp-tmdb-server.js:767-769 (registration)

  Registration of the ListToolsRequestHandler which exposes the movie_reviews tool (along with others) via the tools.map, providing name, description, and inputSchema to MCP clients.

  server.setRequestHandler(ListToolsRequestSchema, async (_req) => ({
      tools: tools.map(({name, description, inputSchema}) => ({name, description, inputSchema})),
  }));

• mcp-tmdb-server.js:771-789 (registration)

  Registration of the CallToolRequestHandler which dispatches calls to the movie_reviews tool's handler by finding it in the tools array by name and executing it with the provided arguments.

  server.setRequestHandler(CallToolRequestSchema, async (req) => {
      const {name, arguments: args} = req.params || {};
      const tool = tools.find(t => t.name === name);
      if (!tool) {
          await sendLog("error", `Unknown tool called: ${name || "<missing>"} with args: ${JSON.stringify(args || {})}`);
          throw new Error(`Unknown tool: ${name}`);
      }
      await sendLog("info", `Calling tool: ${name} with args: ${JSON.stringify(args || {})}`);
      try {
          const start = Date.now();
          const res = await tool.handler(args || {});
          const ms = Date.now() - start;
          await sendLog("info", `Tool success: ${name} in ${ms}ms`);
          return res;
      } catch (err) {
          await sendLog("error", `Tool error: ${name} -> ${err && err.message ? err.message : String(err)}`);
          throw err;
      }
  });