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)

TMDB MCP Server

Integrations