{"_id":"@atharva-think/tmdb-mcp-server","name":"@atharva-think/tmdb-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@atharva-think/tmdb-mcp-server","version":"1.0.0","description":"A Model Context Protocol server for The Movie Database (TMDB) API","main":"dist/server.js","type":"module","scripts":{"build":"tsc","start":"node dist/server.js","dev":"ts-node --esm src/server.ts","clean":"rm -rf dist"},"keywords":["mcp","model-context-protocol","tmdb","movies","api"],"author":{"name":"Atharva Think"},"repository":{"type":"git","url":"git+https://github.com/atharva-think/tmdb-mcp-server.git"},"homepage":"https://github.com/atharva-think/tmdb-mcp-server#readme","bugs":{"url":"https://github.com/atharva-think/tmdb-mcp-server/issues"},"bin":{"tmdb-mcp-server":"dist/server.js"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.17.5","dotenv":"^16.4.5","zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.11.0","typescript":"^5.3.3","ts-node":"^10.9.2"},"engines":{"node":">=18.0.0"},"_id":"@atharva-think/tmdb-mcp-server@1.0.0","types":"./dist/server.d.ts","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-fkYJ0xQ0fH2cq4iT2NgTdOZyc7ZpFQ5sP8ywSJInmOGjozNMr4zZHzbeurrPq5LJJckz/PxKJtOzZ2yl28BTxA==","shasum":"a70c45d4f32b25b10f4977c949fe9f680c42e914","tarball":"https://registry.npmjs.org/@atharva-think/tmdb-mcp-server/-/tmdb-mcp-server-1.0.0.tgz","fileCount":27,"unpackedSize":171726,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGq1cDJwBj8RoUtPAcbIdk22siyurBbWASb84NGfyBRmAiEA9/keoSJrFk+0Ap6idlc34UI5hjlL/xuHbIRQIyGQwfU="}]},"_npmUser":{"name":"atharva-think","email":"atharva.bhanage@thinkitive.com"},"directories":{},"maintainers":[{"name":"atharva-think","email":"atharva.bhanage@thinkitive.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tmdb-mcp-server_1.0.0_1757420813509_0.2723771276375193"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-09T12:26:53.402Z","1.0.0":"2025-09-09T12:26:53.682Z","modified":"2025-09-09T12:26:53.912Z"},"maintainers":[{"name":"atharva-think","email":"atharva.bhanage@thinkitive.com"}],"description":"A Model Context Protocol server for The Movie Database (TMDB) API","homepage":"https://github.com/atharva-think/tmdb-mcp-server#readme","keywords":["mcp","model-context-protocol","tmdb","movies","api"],"repository":{"type":"git","url":"git+https://github.com/atharva-think/tmdb-mcp-server.git"},"author":{"name":"Atharva Think"},"bugs":{"url":"https://github.com/atharva-think/tmdb-mcp-server/issues"},"license":"MIT","readme":"# TMDB MCP Server\n\nA Model Context Protocol (MCP) server that provides access to The Movie Database (TMDB) API. This server enables AI assistants like Cursor to search for movies, TV shows, people, get detailed information, trending content, and recommendations.\n\n## Features\n\n### 🔍 Search Tools\n- **Search Movies**: Find movies by title with optional year filtering\n- **Search TV Shows**: Find TV shows by name with optional year filtering  \n- **Search People**: Find actors, directors, and other industry professionals\n- **Multi Search**: Universal search across movies, TV shows, and people\n\n### 📱 Details Tools\n- **Movie Details**: Get comprehensive movie information including cast, crew, budget, revenue\n- **TV Show Details**: Get detailed TV show information including seasons, episodes, networks\n- **Person Details**: Get detailed person information including biography and filmography\n- **Movie Credits**: Get cast and crew information for movies\n- **TV Show Credits**: Get cast and crew information for TV shows\n\n### 📈 Discovery Tools\n- **Trending Content**: Get trending movies, TV shows, and people (daily/weekly)\n- **Popular Content**: Get most popular movies, TV shows, and people\n- **Recommendations**: Get movie and TV show recommendations based on specific titles\n- **Similar Content**: Find similar movies and TV shows\n\n## Prerequisites\n\n- Node.js 18.x or higher\n- TMDB API key (free registration at [TMDB](https://developer.themoviedb.org/docs/getting-started))\n\n## Setup\n\n1. **Install Dependencies**\n   ```bash\n   npm install\n   ```\n\n2. **Get TMDB API Key**\n   - Go to [TMDB API](https://developer.themoviedb.org/docs/getting-started)\n   - Register for a free account\n   - Generate an API key\n\n3. **Configure Environment**\n   - Copy `.env` file and add your API key:\n   ```bash\n   TMDB_API_KEY=your_actual_api_key_here\n   TMDB_BASE_URL=https://api.themoviedb.org/3\n   ```\n\n4. **Build the Project**\n   ```bash\n   npm run build\n   ```\n\n## Usage\n\n### Running the Server Directly\n```bash\nnpm start\n```\n\n### Development Mode\n```bash\nnpm run dev\n```\n\n### Integration with Cursor\n\nAdd this configuration to your Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"tmdb\": {\n      \"command\": \"node\",\n      \"args\": [\"/home/ttpl-lnvl15-0288/Projects/movie-mcp/dist/server.js\"],\n      \"cwd\": \"/home/ttpl-lnvl15-0288/Projects/movie-mcp\"\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Search Tools\n- `search_movies(query, year?, page?)` - Search for movies\n- `search_tv_shows(query, year?, page?)` - Search for TV shows\n- `search_people(query, page?)` - Search for people\n- `search_multi(query, page?)` - Universal search\n\n### Details Tools\n- `get_movie_details(id)` - Get detailed movie information\n- `get_tv_show_details(id)` - Get detailed TV show information\n- `get_person_details(id)` - Get detailed person information\n- `get_movie_credits(id)` - Get movie cast and crew\n- `get_tv_show_credits(id)` - Get TV show cast and crew\n\n### Discovery Tools\n- `get_trending_movies(timeWindow?, page?)` - Get trending movies\n- `get_trending_tv_shows(timeWindow?, page?)` - Get trending TV shows\n- `get_trending_people(timeWindow?, page?)` - Get trending people\n- `get_popular_movies(page?)` - Get popular movies\n- `get_popular_tv_shows(page?)` - Get popular TV shows\n- `get_popular_people(page?)` - Get popular people\n- `get_movie_recommendations(id, page?)` - Get movie recommendations\n- `get_tv_show_recommendations(id, page?)` - Get TV show recommendations\n- `get_similar_movies(id, page?)` - Get similar movies\n- `get_similar_tv_shows(id, page?)` - Get similar TV shows\n\n## Example Usage\n\nOnce connected through Cursor, you can ask questions like:\n\n- \"Search for movies about space exploration\"\n- \"Get details about the movie Inception\"\n- \"What are the trending movies this week?\"\n- \"Find movies similar to The Matrix\"\n- \"Who are the most popular actors right now?\"\n- \"Get the cast and crew for Breaking Bad\"\n\n## Rate Limiting\n\nThe server implements TMDB's rate limiting (40 requests per 10 seconds) automatically with proper queuing and retry logic.\n\n## Error Handling\n\n- Comprehensive error handling for API failures\n- Input validation using Zod schemas\n- Graceful handling of network errors and rate limits\n\n## Future Expansions\n\nThis architecture can be easily adapted for other APIs such as:\n- **Athena Health**: Patient data, appointment scheduling, clinical workflows\n- **Cerner**: EHR integration, clinical decision support, reporting\n- **Epic MyChart**: Patient portal integration, health records access\n\n## Development\n\n### Project Structure\n```\nsrc/\n├── server.ts              # Main MCP server\n├── tmdb-client.ts         # TMDB API wrapper\n├── types/\n│   └── tmdb.ts           # TypeScript type definitions\n└── tools/\n    ├── search.ts         # Search tools\n    ├── details.ts        # Details tools\n    └── discovery.ts      # Discovery tools\n```\n\n### Scripts\n- `npm run build` - Build TypeScript to JavaScript\n- `npm run dev` - Run in development mode with ts-node\n- `npm start` - Start the built server\n- `npm run clean` - Clean build directory\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## Support\n\nFor issues and questions:\n1. Check the TMDB API documentation\n2. Verify your API key is valid\n3. Check server logs for error messages\n4. Ensure Node.js version compatibility\n","readmeFilename":"README.md","_rev":"1-e545de63e0ecde88741f5a73cd4acd0b"}