{"_id":"@adamayoung/mcp-server-tmdb","name":"@adamayoung/mcp-server-tmdb","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@adamayoung/mcp-server-tmdb","version":"1.0.0","description":"MCP server for The Movie Database (TMDB) API - search movies, get recommendations, trending movies, and detailed movie information","main":"dist/index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc && shx chmod +x dist/*.js","prepare":"npm run build","watch":"tsc --watch"},"keywords":["mcp","mcp-server","tmdb","movies","model-context-protocol","claude","ai"],"author":{"name":"Adam Young"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/adamayoung/tmdb-mcp.git"},"homepage":"https://github.com/adamayoung/tmdb-mcp#readme","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.3","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^22.10.1","@types/node-fetch":"^2.6.12","shx":"^0.3.4","typescript":"^5.7.2"},"type":"module","bin":{"mcp-server-tmdb":"dist/index.js"},"gitHead":"f6fe2e149141277b17d96b34f0ee9c8d8064e733","_id":"@adamayoung/mcp-server-tmdb@1.0.0","bugs":{"url":"https://github.com/adamayoung/tmdb-mcp/issues"},"_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-DITiCtnFehFTat9yGttnOYeQXaXITj0KBIMscLTVpW7fghd+wF44HMctQ58o7wS7KJO1nopT0jK2h+9vZJcIAw==","shasum":"156464b706a283c7cf304f156d09553688424568","tarball":"https://registry.npmjs.org/@adamayoung/mcp-server-tmdb/-/mcp-server-tmdb-1.0.0.tgz","fileCount":4,"unpackedSize":123857,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCnAUE6omiSIwaUQnMEj6GqULnfxS9Og4Q6YAlLTBamogIhAJwKt95rBkPDD5jLZb85xgXMF+vJ0E1Cc25sxTKjuvO0"}]},"_npmUser":{"name":"adamayoung","email":"me@adam-young.co.uk"},"directories":{},"maintainers":[{"name":"adamayoung","email":"me@adam-young.co.uk"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-tmdb_1.0.0_1772051121722_0.9203783008243027"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-25T20:25:21.648Z","1.0.0":"2026-02-25T20:25:21.854Z","modified":"2026-02-25T20:25:22.023Z"},"maintainers":[{"name":"adamayoung","email":"me@adam-young.co.uk"}],"description":"MCP server for The Movie Database (TMDB) API - search movies, get recommendations, trending movies, and detailed movie information","homepage":"https://github.com/adamayoung/tmdb-mcp#readme","keywords":["mcp","mcp-server","tmdb","movies","model-context-protocol","claude","ai"],"repository":{"type":"git","url":"git+https://github.com/adamayoung/tmdb-mcp.git"},"author":{"name":"Adam Young"},"bugs":{"url":"https://github.com/adamayoung/tmdb-mcp/issues"},"license":"MIT","readme":"[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/laksh-star-mcp-server-tmdb-badge.png)](https://mseep.ai/app/laksh-star-mcp-server-tmdb)\n\n# TMDB MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@Laksh-star/mcp-server-tmdb)](https://smithery.ai/server/@Laksh-star/mcp-server-tmdb)\nThis MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.\n\n\"mcp-server-tmdb\n\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Laksh-star/mcp-server-tmdb)\n## Prerequisites\n\nBefore installing and running the TMDB MCP server, ensure you have the following prerequisites installed and configured:\n\n### Required software\n\n- **Node.js**\n - Version 18.0.0 or higher\n - Download from [Node.js official website](https://nodejs.org/)\n - Verify installation: `node --version`\n\n- **npm (Node Package Manager)**\n - Version 8.0.0 or higher (comes with Node.js)\n - Verify installation: `npm --version`\n\n- **TypeScript**\n - Will be installed as a project dependency\n - Can be installed globally: `npm install -g typescript`\n - Verify installation: `tsc --version`\n\n### Required accounts & API keys\n\n- **TMDB account**\n - Free account at [TMDB](https://www.themoviedb.org/)\n - API key from TMDB dashboard\n - API access must be approved by TMDB\n\n- **Claude desktop application**\n - Latest version installed\n - Access to modify configuration files\n\n### System requirements\n\n- **Operating systems**\n - macOS (10.15 or later)\n - Linux (modern distributions)\n\n- **Hardware requirements**\n- Minimum 4GB RAM\n - 1GB free disk space\n - Stable internet connection\n\n### Development environment\n\nFor the best development experience, we recommend:\n- A code editor with TypeScript support (e.g., VS Code)\n- Terminal access\n- Git (for version control)\n\n## Features\n\n### Tools\n\n- **search_movies**\n - Search for movies by title or keywords\n - Input: `query` (string): Search query\n - Returns: List of movies with titles, release years, IDs, ratings, and overviews\n - Example: Search for movies about space exploration\n\n- **get_recommendations**\n - Get movie recommendations based on a movie ID\n - Input: `movieId` (string): TMDB movie ID\n - Returns: Top 5 recommended movies with details\n - Example: Get recommendations based on movie ID 550 (Fight Club)\n\n- **get_trending**\n - Get trending movies for a specified time window\n - Input: `timeWindow` (string): Either \"day\" or \"week\"\n - Returns: Top 10 trending movies with details\n - Example: Get today's trending movies\n\n### Resources\n\nThe server provides access to TMDB movie information:\n\n- **Movies** (`tmdb:///movie/`)\n - Comprehensive movie details including:\n - Title and release date\n - Rating and overview\n - Genres\n - Poster URL\n - Cast information (top 5 actors)\n - Director\n - Selected reviews\n - All data is returned in JSON format\n\n## Getting started\n\n1. Get a TMDB API key:\n - Sign up at [TMDB](https://www.themoviedb.org/)\n - Go to your account settings\n - Navigate to the API section\n - Request an API key for developer use\n\n2. Clone and set up the project:\n ```bash\n git clone [repository-url]\n cd mcp-server-tmdb\n npm install\n ```\n\n3. Build the server:\n ```bash\n npm run build\n ```\n\n4. Set up your environment variable:\n ```bash\n export TMDB_API_KEY=your_api_key_here\n ```\n\n### Usage with Claude Desktop\n\nTo integrate this server with Claude Desktop, add the following to your app's server configuration file (located at `~/Library/Application Support/Claude/config.json`):\n\n```json\n{\n \"mcpServers\": {\n \"tmdb\": {\n \"command\": \"/full/path/to/dist/index.js\",\n \"env\": {\n \"TMDB_API_KEY\": \"your_api_key_here\"\n }\n }\n }\n}\n```\n\nReplace `/full/path/to` with the actual path to your project directory.\n\n### Installing via Smithery\n\nTo install TMDB Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@Laksh-star/mcp-server-tmdb):\n\n```bash\nnpx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claude\n```\n\n## Example usage\n\nOnce the server is running with Claude Desktop, you can use commands like:\n\n1. Search for movies:\n ```\n \"Search for movies about artificial intelligence\"\n ```\n\n2. Get trending movies:\n ```\n \"What are the trending movies today?\"\n \"Show me this week's trending movies\"\n ```\n\n3. Get movie recommendations:\n ```\n \"Get movie recommendations based on movie ID 550\"\n ```\n\n4. Get movie details:\n ```\n \"Tell me about the movie with ID 550\"\n ```\n\n## Error handling\n\nThe server includes comprehensive error handling for:\n- Invalid API keys\n- Network errors\n- Invalid movie IDs\n- Malformed requests\n\nError messages will be returned in a user-friendly format through Claude Desktop.\n\n## Development\n\nTo watch for changes during development:\n```bash\nnpm run watch\n```\n\n## License\n\nThis MCP server is licensed under the MIT License. See the LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","readmeFilename":"README.md","_rev":"1-ad81cf2401fccf62ba9a93fef0b6a805"}