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

1. Clonar este repositorio

   git clone https://github.com/your-username/tmdb-mcp.git cd tmdb-mcp

2. Instalar dependencias

   npm install

3. 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

4. Construir el proyecto

   npm run build

5. Iniciar el servidor

   npm start

Configuración para Claude Desktop

1. Abra Claude Desktop

2. Vaya a Configuración > pestaña Desarrollador

3. Haga clic en "Editar configuración" para abrir el archivo de configuración

4. Añade lo siguiente a tu configuración:

5. 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

Pruebas

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

• La base de datos de películas (TMDB)

• Protocolo de contexto modelo