Servidor MCP de TMDB

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con la API de The Movie Database (TMDB). Permite a asistentes de IA como Claude interactuar con datos cinematográficos, ofreciendo funciones de búsqueda, recuperación de detalles y generación de contenido relacionado con las películas.

Características

Recursos

Recursos estáticos :
- tmdb://info - Información sobre la API de TMDB
- tmdb://trending - Películas que son tendencia actualmente
Plantillas de recursos :
- tmdb://movie/{id} - Información detallada sobre una película específica

Indicaciones

Reseña de película : genere una reseña de película personalizada con un estilo y una calificación específicos
Recomendación de películas : obtén recomendaciones de películas personalizadas según géneros y estados de ánimo.

Herramientas

Buscar películas : Encuentra películas por título o palabras clave
Obtenga películas en tendencia : recupere películas en tendencia por día o semana
Obtener películas similares : encuentre películas similares a una película específica

Instrucciones de configuración

Prerrequisitos

Node.js (v16 o posterior)
npm o hilo
Clave API de TMDB

Instalación

Clonar este repositorio
git clone https://github.com/your-username/tmdb-mcp.git cd tmdb-mcp
Instalar dependencias
npm install
Configurar su clave API de TMDB
- Cree un archivo .env en la raíz del proyecto (alternativa: edite src/config.ts directamente)
- Agregue su clave API de TMDB: TMDB_API_KEY=your_api_key_here
Construir el proyecto
npm run build
Iniciar el servidor
npm start

Configuración para Claude Desktop

Abra Claude Desktop
Vaya a Configuración > pestaña Desarrollador
Haga clic en "Editar configuración" para abrir el archivo de configuración
Añade lo siguiente a tu configuración:

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"]
    }
  }
}

Reiniciar Claude Desktop

Ejemplos de uso

Uso de recursos estáticos

¿Qué es TMDB?
"Muéstrame las películas que están de moda actualmente"

Uso de plantillas de recursos

Obtén detalles de la película con ID 550 (El Club de la Lucha)
Cuéntame sobre la película con ID 155 (El Caballero de la Noche)

Uso de indicaciones

Escribe una reseña detallada de Inception con una calificación de 9/10.
"Recomiendo películas de ciencia ficción para un estado de ánimo reflexivo"

Uso de herramientas

"Busca películas sobre exploración espacial"
"¿Cuáles son las películas de tendencia hoy en día?"
Encuentra películas similares a Matrix

Desarrollo

Estructura del proyecto

tmdb-mcp/
├── src/
│   ├── index.ts                # Main server file
│   ├── config.ts               # Configuration and API keys
│   ├── handlers.ts             # Request handlers
│   ├── resources.ts            # Static resources
│   ├── resource-templates.ts   # Dynamic resource templates
│   ├── prompts.ts              # Prompt definitions
│   ├── tools.ts                # Tool implementations
│   └── tmdb-api.ts             # TMDB API wrapper
├── package.json
├── tsconfig.json
└── README.md

Pruebas

Utilice el Inspector MCP para probar su servidor durante el desarrollo:

npx @modelcontextprotocol/inspector node build/index.js

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Permite que los asistentes de IA como Claude interactúen con la API de The Movie Database (TMDB), proporcionando capacidades para buscar películas, recuperar detalles de películas y generar reseñas y recomendaciones de películas personalizadas.

Related MCP Servers

mcp-server-tmdb
Laksh-star
-
security
A
license
-
quality
Integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
Last updated -
3
33
JavaScript
MIT License
Radarr and Sonarr MCP Server
BerryKuipers
-
security
F
license
-
quality
A Python-based Model Context Protocol server that allows AI assistants like Claude to access and query your movie and TV show collection via Radarr and Sonarr APIs.
Last updated -
3
Python
TMF620 MCP Server
oopsyz
-
security
F
license
-
quality
Allows AI agents to interact with a remote TMF620 Product Catalog Management API, enabling operations like listing, retrieving, and creating catalogs, product offerings, and product specifications.
Last updated -
1
Python
Metabase MCP Server
imlewc
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase databases and dashboards, allowing users to list and execute queries, access data visualizations, and interact with database resources through natural language.
Last updated -
25
JavaScript

View all related MCP servers

TMDB MCP Server