Usher
- typescript
0
GitHub Stars
typescript
Language
7 months ago
First Indexed
3 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
You deploy and run an MCP server that serves a movie detail widget powered by TMDB. This server exposes a UI resource and a tool to fetch movie details and cast, enabling MCP hosts to render rich movie information in apps and widgets with minimal setup.
How to use
You interact with the Usher MCP server through an MCP-compatible client. Start the local development server to run the MCP endpoint and the UI widget, then use the get-movie-detail tool to search TMDB by movie title and retrieve structured movie data including cast information. You can open a showtimes link through the widget, which will launch a browser search for showtimes near you.
How to install
Prerequisites include Node.js version 18 or newer, the Wrangler CLI, and a TMDB API token stored as a secret.
Step-by-step commands you will run locally to install and start the server:
- Install dependencies for the project.
npm install
- Create a local secret for TMDB access.
TMDB_TOKEN=your_tmdb_bearer_token
- Run the local development server for MCP.
npm run dev
Additional setup notes
In local development, secrets can be provided via a file named .dev.vars with key-value pairs. An example is shown here.
TMDB_TOKEN=your_tmdb_bearer_token
Available tools
get-movie-detail
Fetches movie details and cast from TMDB by movie title. Returns a structured movie payload including title, poster/backdrop URLs, runtime, genres, rating, and cast.
