Wizzy Mcp Tmdb

- Search Movies: Perform multi-search across movies, TV shows, and people using thesearch_tmdbtool.
- Get Details: Fetch detailed information for specific items using theget_tmdb_detailstool.
- Trending Content: Retrieve trending content across all media types with thetrending_alltool.

- Node.js version 18 or higher (required for global fetch support)
- A TMDB API key (Bearer token) from your admin, used with the TNL TMDB proxy (production-api.tnl.one)
-

Clone the repository and navigate to the project directory.

Set up your TMDB API key as an environment variable:

$env:TMDB_AUTH_TOKEN="YOUR_TNL_PROXY_BEARER_TOKEN"

export TMDB_AUTH_TOKEN="YOUR_TNL_PROXY_BEARER_TOKEN"

The server communicates over stdio and should be configured in your MCP-compatible client (e.g., IDE or chat client) with the commandnode mcp-tmdb-server.jsand theTMDB_AUTH_TOKENenvironment variable.

Here are code snippets showing how to integrate with the MCP tools:

// Example MCP tool call for searching { "method": "tools/call", "params": { "name": "search_tmdb", "arguments": { "query": "dune", "page": 1, "language": "en-US", "include_adult": false } } }

// Example MCP tool call for getting details { "method": "tools/call", "params": { "name": "get_tmdb_details", "arguments": { "type": "movie", "id": 438631, "append": "credits,images" } } }

// Example MCP tool call for trending content { "method": "tools/call", "params": { "name": "trending_all", "arguments": { "time_window": "day", "page": 1, "language": "en-US" } } }

Per integrare questo MCP server nel tuo client MCP (come un IDE o un client di chat compatibile), segui questi passi:
-

Installa il pacchetto npm se necessario:

Crea o aggiorna il filemcp.jsonnel tuo client MCP con la seguente configurazione:

{ "mcpServers": { "tmdb": { "command": "npx", "args": ["wizzy-mcp-tmdb"], "env": { "TMDB_AUTH_TOKEN": "YOUR_TNL_PROXY_BEARER_TOKEN" }, "alwaysAllow": [ "get_watch_providers", "discover_tv", "discover_by_provider" ] } } }

Nota: IlTMDB_AUTH_TOKENpuò essere impostato a un valore casuale per ora, poiché le chiamate API TMDB sono gratuite e non richiedono autenticazione obbligatoria.

The project uses Jest for comprehensive testing, including:

- Unit Tests: Validate individual handler functions, input validation, and response formatting (seetests/unit/handlers.test.js).
- Integration Tests: Test API interactions with mocked responses, error handling, and network failures (seetests/integration/api.test.js).
- Protocol Tests: Ensure MCP protocol compliance, including tool listing and calling (seetests/protocol/mcp.test.js).

wizzy-mcp-tmdb/ ├── mcp-tmdb-server.js # Main MCP server implementation ├── package.json # Project configuration and dependencies ├── MCP_GUIDE.md # Detailed MCP integration guide ├── babel.config.cjs # Babel configuration for Jest ├── tests/ │ ├── unit/ │ │ └── handlers.test.js # Unit tests for handlers │ ├── integration/ │ │ └── api.test.js # Integration tests for API calls │ └── protocol/ │ └── mcp.test.js # MCP protocol compliance tests └── tests/fixtures/ # Mock data for tests ├── movieDetails.json ├── searchMultiResponse.json └── trendingAllResponse.json

We welcome contributions! Please follow these guidelines:
- Fork the repository.
- Create a feature branch.
- Make your changes and add tests.
- Ensure all tests pass.
- Submit a pull request.

This project is licensed under the MIT License. See the LICENSE file for details.

- Thanks to The Movie Database (TMDB) for providing the API.
- Built using the Model Context Protocol SDK.

For questions or support, please open an issue on GitHub.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

Research tools, including a Sqlite-backed document stash

Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.

SerpApi MCP Server for Google and other search engine results