@lonzzi/tmdb-mcp-server 1.0.3 → 1.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 lonzzi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,10 +4,12 @@ A Model Context Protocol (MCP) server that allows LLMs to search for movies and
 
 ## Features
 
-- **Search Movies**: Find movies by title and get metadata including ID, URL, release date, rating, and overview.
-- **Search TV Shows**: Find TV shows by title and get metadata including ID, URL, first air date, rating, and overview.
+- **Search Movies**: Find movies by title with support for region and language.
+- **Search TV Shows**: Find TV shows by title with language support.
+- **Get Details**: Retrieve detailed metadata for movies and TV shows (runtime, budget, seasons, etc.).
+- **Trending**: Discover today's or this week's trending movies and TV shows.
+- **Search People**: Search for actors, directors, and other crew members.
 - **Direct Links**: Provides TMDb URLs for easy access to more details.
-- **Top Results**: Returns the top 5 most relevant results for each query.
 
 ## Prerequisites
 
@@ -28,7 +30,7 @@ To use this server with Claude Desktop, add it to your `claude_desktop_config.js
   "mcpServers": {
     "tmdb": {
       "command": "npx",
-      "args": ["@lonzzi/tmdb-mcp-server"],
+      "args": ["-y", "@lonzzi/tmdb-mcp-server"],
       "env": {
         "TMDB_API_KEY": "your_api_key_here"
       }
@@ -39,12 +41,16 @@ To use this server with Claude Desktop, add it to your `claude_desktop_config.js
 
 ## Available Tools
 
+All tools support an optional `language` argument (e.g., `en-US`, `zh-CN`, `fr-FR`) to get localized results. Default is `en-US`.
+
 ### `search_movies`
 
 Search for movies on TMDB by title.
 
 - **Arguments**:
   - `query` (string, required): The movie title to search for.
+  - `language` (string, optional): Language code (default: `en-US`).
+  - `region` (string, optional): ISO 3166-1 code to filter release dates (e.g., `US`, `KR`).
 
 ### `search_tv_shows`
 
@@ -52,6 +58,47 @@ Search for TV shows on TMDB by title.
 
 - **Arguments**:
   - `query` (string, required): The TV show title to search for.
+  - `language` (string, optional): Language code (default: `en-US`).
+
+### `get_movie_details`
+
+Get detailed information about a specific movie.
+
+- **Arguments**:
+  - `movieId` (number, required): The TMDB ID of the movie.
+  - `language` (string, optional): Language code (default: `en-US`).
+
+### `get_tv_show_details`
+
+Get detailed information about a specific TV show.
+
+- **Arguments**:
+  - `tvShowId` (number, required): The TMDB ID of the TV show.
+  - `language` (string, optional): Language code (default: `en-US`).
+
+### `get_trending_movies`
+
+Get the daily or weekly trending movies.
+
+- **Arguments**:
+  - `timeWindow` (string, optional): `day` or `week` (default: `week`).
+  - `language` (string, optional): Language code (default: `en-US`).
+
+### `get_trending_tv`
+
+Get the daily or weekly trending TV shows.
+
+- **Arguments**:
+  - `timeWindow` (string, optional): `day` or `week` (default: `week`).
+  - `language` (string, optional): Language code (default: `en-US`).
+
+### `search_person`
+
+Search for people (actors, directors, etc.).
+
+- **Arguments**:
+  - `query` (string, required): The name to search for.
+  - `language` (string, optional): Language code (default: `en-US`).
 
 ## Development
 

package/build/index.js

@@ -23,10 +23,15 @@ server.registerTool("search_movies", {
     description: "Search for movies on TMDB by title to get metadata like overview, release date, and rating",
     inputSchema: zod_1.z.object({
         query: zod_1.z.string().describe("The movie title to search for"),
+        language: zod_1.z
+            .string()
+            .optional()
+            .describe("Language code (e.g. 'en-US', 'zh-CN')"),
+        region: zod_1.z.string().optional().describe("Region code (e.g. 'US', 'FR')"),
     }),
-}, async ({ query }) => {
+}, async ({ query, language, region }) => {
     try {
-        const result = await (0, tmdb_1.searchMovies)(API_KEY, query);
+        const result = await (0, tmdb_1.searchMovies)(API_KEY, query, language, region);
         return {
             content: [
                 {
@@ -52,10 +57,185 @@ server.registerTool("search_tv_shows", {
     description: "Search for TV shows on TMDB by title to get metadata like overview, first air date, and rating",
     inputSchema: zod_1.z.object({
         query: zod_1.z.string().describe("The TV show title to search for"),
+        language: zod_1.z
+            .string()
+            .optional()
+            .describe("Language code (e.g. 'en-US', 'zh-CN')"),
     }),
-}, async ({ query }) => {
+}, async ({ query, language }) => {
     try {
-        const result = await (0, tmdb_1.searchTvShows)(API_KEY, query);
+        const result = await (0, tmdb_1.searchTvShows)(API_KEY, query, language);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: error.message || "Unknown error occurred",
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.registerTool("get_movie_details", {
+    description: "Get detailed information about a specific movie by its ID",
+    inputSchema: zod_1.z.object({
+        movieId: zod_1.z.number().describe("The ID of the movie"),
+        language: zod_1.z
+            .string()
+            .optional()
+            .describe("Language code (e.g. 'en-US', 'zh-CN')"),
+    }),
+}, async ({ movieId, language }) => {
+    try {
+        const result = await (0, tmdb_1.getMovieDetails)(API_KEY, movieId, language);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: error.message || "Unknown error occurred",
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.registerTool("get_tv_show_details", {
+    description: "Get detailed information about a specific TV show by its ID",
+    inputSchema: zod_1.z.object({
+        tvShowId: zod_1.z.number().describe("The ID of the TV show"),
+        language: zod_1.z
+            .string()
+            .optional()
+            .describe("Language code (e.g. 'en-US', 'zh-CN')"),
+    }),
+}, async ({ tvShowId, language }) => {
+    try {
+        const result = await (0, tmdb_1.getTvShowDetails)(API_KEY, tvShowId, language);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: error.message || "Unknown error occurred",
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.registerTool("get_trending_movies", {
+    description: "Get a list of trending movies",
+    inputSchema: zod_1.z.object({
+        timeWindow: zod_1.z
+            .enum(["day", "week"])
+            .optional()
+            .describe("Time window for trending content (default: week)"),
+        language: zod_1.z
+            .string()
+            .optional()
+            .describe("Language code (e.g. 'en-US', 'zh-CN')"),
+    }),
+}, async ({ timeWindow = "week", language }) => {
+    try {
+        const result = await (0, tmdb_1.getTrendingMovies)(API_KEY, timeWindow, language);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: error.message || "Unknown error occurred",
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.registerTool("get_trending_tv", {
+    description: "Get a list of trending TV shows",
+    inputSchema: zod_1.z.object({
+        timeWindow: zod_1.z
+            .enum(["day", "week"])
+            .optional()
+            .describe("Time window for trending content (default: week)"),
+        language: zod_1.z
+            .string()
+            .optional()
+            .describe("Language code (e.g. 'en-US', 'zh-CN')"),
+    }),
+}, async ({ timeWindow = "week", language }) => {
+    try {
+        const result = await (0, tmdb_1.getTrendingTvShows)(API_KEY, timeWindow, language);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: error.message || "Unknown error occurred",
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.registerTool("search_person", {
+    description: "Search for people (actors, directors, etc.) on TMDB",
+    inputSchema: zod_1.z.object({
+        query: zod_1.z.string().describe("The name of the person to search for"),
+        language: zod_1.z
+            .string()
+            .optional()
+            .describe("Language code (e.g. 'en-US', 'zh-CN')"),
+    }),
+}, async ({ query, language }) => {
+    try {
+        const result = await (0, tmdb_1.searchPeople)(API_KEY, query, language);
         return {
             content: [
                 {

package/build/tmdb.js

@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchTvShows = exports.searchMovies = void 0;
+exports.searchPeople = exports.getTrendingTvShows = exports.getTrendingMovies = exports.getTvShowDetails = exports.getMovieDetails = exports.searchTvShows = exports.searchMovies = void 0;
 const axios_1 = __importDefault(require("axios"));
-const searchMovies = async (apiKey, query) => {
+const searchMovies = async (apiKey, query, language = "en-US", region) => {
     if (!query) {
         throw new Error("Query argument is required");
     }
@@ -14,7 +14,8 @@ const searchMovies = async (apiKey, query) => {
             params: {
                 api_key: apiKey,
                 query: query,
-                language: "en-US",
+                language: language,
+                ...(region && { region }),
                 page: 1,
             },
         });
@@ -28,7 +29,7 @@ const searchMovies = async (apiKey, query) => {
     }
 };
 exports.searchMovies = searchMovies;
-const searchTvShows = async (apiKey, query) => {
+const searchTvShows = async (apiKey, query, language = "en-US") => {
     if (!query) {
         throw new Error("Query argument is required");
     }
@@ -37,7 +38,7 @@ const searchTvShows = async (apiKey, query) => {
             params: {
                 api_key: apiKey,
                 query: query,
-                language: "en-US",
+                language: language,
                 page: 1,
             },
         });
@@ -51,3 +52,98 @@ const searchTvShows = async (apiKey, query) => {
     }
 };
 exports.searchTvShows = searchTvShows;
+const getMovieDetails = async (apiKey, movieId, language = "en-US") => {
+    try {
+        const response = await axios_1.default.get(`https://api.themoviedb.org/3/movie/${movieId}`, {
+            params: {
+                api_key: apiKey,
+                language: language,
+            },
+        });
+        return response.data;
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error)) {
+            throw new Error(`TMDB API Error: ${error.message}`);
+        }
+        throw error;
+    }
+};
+exports.getMovieDetails = getMovieDetails;
+const getTvShowDetails = async (apiKey, tvShowId, language = "en-US") => {
+    try {
+        const response = await axios_1.default.get(`https://api.themoviedb.org/3/tv/${tvShowId}`, {
+            params: {
+                api_key: apiKey,
+                language: language,
+            },
+        });
+        return response.data;
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error)) {
+            throw new Error(`TMDB API Error: ${error.message}`);
+        }
+        throw error;
+    }
+};
+exports.getTvShowDetails = getTvShowDetails;
+const getTrendingMovies = async (apiKey, timeWindow = "week", language = "en-US") => {
+    try {
+        const response = await axios_1.default.get(`https://api.themoviedb.org/3/trending/movie/${timeWindow}`, {
+            params: {
+                api_key: apiKey,
+                language: language,
+            },
+        });
+        return response.data.results.slice(0, 10);
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error)) {
+            throw new Error(`TMDB API Error: ${error.message}`);
+        }
+        throw error;
+    }
+};
+exports.getTrendingMovies = getTrendingMovies;
+const getTrendingTvShows = async (apiKey, timeWindow = "week", language = "en-US") => {
+    try {
+        const response = await axios_1.default.get(`https://api.themoviedb.org/3/trending/tv/${timeWindow}`, {
+            params: {
+                api_key: apiKey,
+                language: language,
+            },
+        });
+        return response.data.results.slice(0, 10);
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error)) {
+            throw new Error(`TMDB API Error: ${error.message}`);
+        }
+        throw error;
+    }
+};
+exports.getTrendingTvShows = getTrendingTvShows;
+const searchPeople = async (apiKey, query, language = "en-US") => {
+    if (!query) {
+        throw new Error("Query argument is required");
+    }
+    try {
+        const response = await axios_1.default.get("https://api.themoviedb.org/3/search/person", {
+            params: {
+                api_key: apiKey,
+                query: query,
+                language: language,
+                page: 1,
+            },
+        });
+        return response.data.results.slice(0, 5);
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error)) {
+            throw new Error(`TMDB API Error: ${error.message}`);
+        }
+        throw error;
+    }
+};
+exports.searchPeople = searchPeople;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lonzzi/tmdb-mcp-server",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for searching movies on TMDB",
   "main": "build/index.js",
   "bin": {
@@ -15,9 +15,9 @@
   "files": [
     "build"
   ],
-  "keywords": [],
+  "keywords": ["tmdb", "mcp", "modelcontextprotocol", "movie", "tv show", "search"],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "homepage": "https://github.com/lonzzi/tmdb-mcp-server",
   "repository": {
     "type": "git",