mcp-server-tmdb

Servidor MCP de TMDB

Este servidor MCP se integra con la API de The Movie Database (TMDB) para proporcionar información sobre películas, capacidades de búsqueda y recomendaciones.

Prerrequisitos

Antes de instalar y ejecutar el servidor TMDB MCP, asegúrese de tener instalados y configurados los siguientes requisitos previos:

Software requerido

• Node.js
  • Versión 18.0.0 o superior
  • Descargar desde el sitio web oficial de Node.js
  • Verificar la instalación: node --version
• npm (Administrador de paquetes de Node)
  • Versión 8.0.0 o superior (viene con Node.js)
  • Verificar la instalación: npm --version
• Mecanografiado
  • Se instalará como una dependencia del proyecto.
  • Se puede instalar globalmente: npm install -g typescript
  • Verificar la instalación: tsc --version

Cuentas y claves API requeridas

• Cuenta TMDB
  • Cuenta gratuita en TMDB
  • Clave API del panel de TMDB
  • El acceso a la API debe ser aprobado por TMDB
• Aplicación de escritorio Claude
  • Última versión instalada
  • Acceso para modificar archivos de configuración

Requisitos del sistema

• Sistemas operativos
  • macOS (10.15 o posterior)
  • Linux (distribuciones modernas)
• Requisitos de hardware
  • Mínimo 4 GB de RAM
  • 1 GB de espacio libre en disco
  • Conexión a Internet estable

Entorno de desarrollo

Para la mejor experiencia de desarrollo, recomendamos:

• Un editor de código con soporte para TypeScript (por ejemplo, VS Code)
• Acceso a la terminal
• Git (para control de versiones)

Características

Herramientas

• buscar_películas
  • Buscar películas por título o palabras clave
  • Entrada: query (cadena): Consulta de búsqueda
  • Devoluciones: Lista de películas con títulos, años de estreno, identificaciones, calificaciones y descripciones generales
  • Ejemplo: Buscar películas sobre exploración espacial
• obtener recomendaciones
  • Obtenga recomendaciones de películas según la identificación de la película
  • Entrada: movieId (cadena): ID de película de TMDB
  • Regresa: Las 5 mejores películas recomendadas con detalles
  • Ejemplo: Obtener recomendaciones basadas en el ID de película 550 (El club de la lucha)
• obtener_tendencia
  • Obtenga películas de tendencia durante un período de tiempo específico
  • Entrada: timeWindow (cadena): "día" o "semana"
  • Regresa: Las 10 películas más populares con detalles
  • Ejemplo: Obtenga las películas de tendencia de hoy

Recursos

El servidor proporciona acceso a la información de películas de TMDB:

• Películas ( tmdb:///movie/<movie_id> )
  • Detalles completos de la película que incluyen:
    • Título y fecha de lanzamiento
    • Calificación y descripción general
    • Géneros
    • URL del póster
    • Información del reparto (los 5 mejores actores)
    • Director
    • Reseñas seleccionadas
  • Todos los datos se devuelven en formato JSON

Empezando

1. Obtenga una clave API de TMDB:
   • Regístrate en TMDB
   • Vaya a la configuración de su cuenta
   • Navegar a la sección API
   • Solicitar una clave API para uso del desarrollador
2. Clonar y configurar el proyecto:
   git clone [repository-url] cd mcp-server-tmdb npm install
3. Construir el servidor:
   npm run build
4. Configure su variable de entorno:
   export TMDB_API_KEY=your_api_key_here

Uso con Claude Desktop

Para integrar este servidor con Claude Desktop, agregue lo siguiente al archivo de configuración del servidor de su aplicación (ubicado en ~/Library/Application Support/Claude/config.json ):

Reemplace /full/path/to con la ruta real al directorio de su proyecto.

Instalación mediante herrería

Para instalar TMDB Server para Claude Desktop automáticamente a través de Smithery :

Ejemplo de uso

Una vez que el servidor esté funcionando con Claude Desktop, puedes usar comandos como:

1. Buscar películas:
   "Search for movies about artificial intelligence"
2. Obtenga películas de tendencia:
   "What are the trending movies today?" "Show me this week's trending movies"
3. Obtenga recomendaciones de películas:
   "Get movie recommendations based on movie ID 550"
4. Obtener detalles de la película:
   "Tell me about the movie with ID 550"

Manejo de errores

El servidor incluye un manejo integral de errores para:

• Claves API no válidas
• Errores de red
• ID de películas no válidas
• Solicitudes malformadas

Los mensajes de error se devolverán en un formato fácil de usar a través de Claude Desktop.

Desarrollo

Para observar los cambios durante el desarrollo:

Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Consulte el archivo de licencia para obtener más información.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.