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

Related MCP server: TMDB MCP Server

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:

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

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

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

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

• Protocolo de contexto modelo