Servidor MCP

Dale a un asistente de IA acceso en vivo a javinfo con @javinfo/mcp — un servidor MCP stdio que expone la búsqueda y la consulta de películas como herramientas.

@javinfo/mcp es un servidor Model Context Protocol (stdio) que envuelve la API de javinfo. Apúntalo a cualquier cliente MCP — Claude Desktop, Claude Code, Cursor, VS Code — y el asistente podrá buscar títulos y obtener registros completos por sí mismo. Los mismos datos que la API REST, sin código de pegamento.

Configuración

El servidor necesita tu clave jvi_ en la variable de entorno JAVINFO_API_KEY. Obtén una desde el panel de control — consulta Autenticación.

Añádela a la configuración MCP de tu cliente. Esta es la forma estándar mcpServers (Claude Desktop, Cursor, VS Code y Claude Code la usan):

mcp.json

{
  "mcpServers": {
    "javinfo": {
      "command": "npx",
      "args": ["-y", "@javinfo/mcp"],
      "env": { "JAVINFO_API_KEY": "jvi_your_key_here" }
    }
  }
}

npx -y descarga y ejecuta la última versión publicada — sin instalación global. Reinicia el cliente y aparecen las herramientas javinfo-search / javinfo-movie.

La clave queda en texto plano en la configuración del cliente. Mantén ese archivo privado — se factura por cada búsqueda correcta, igual que la API REST. Consulta límites de tasa y facturación.

Herramientas

Dos herramientas, pensadas para encadenarse: buscar para encontrar el código DVD exacto, y luego obtener su registro completo.

`javinfo-search`

Busca por código DVD, título o actriz. Devuelve una lista compacta de coincidencias.

Argumento	Tipo	Notas
`q`	string, obligatorio	Código, título o nombre de actriz — p. ej. `AVSA-210`.
`providers`	string o array, opcional	Restringir fuentes. `fanza`, `dmm`, `missav`, `javdatabase`. Por defecto todas.

javdb no está disponible aquí (solo por código) — usa javinfo-movie para los enlaces de descarga.

`javinfo-movie`

Obtiene un registro completo por su DVD id exacto (el que obtuviste en la búsqueda).

Argumento	Tipo	Notas
`q`	string, obligatorio	DVD id exacto — p. ej. `AVSA-210`.
`providers`	string o array, opcional	`fanza`, `dmm`, `javdb`, `missav`, `javdatabase`. Por defecto todas.
`includeImages`	boolean, opcional	Añade URLs de carátula, muestras y galería. Por defecto `false`.

Las URLs de imágenes se omiten por defecto para mantener respuestas ligeras en tokens — activa includeImages: true cuando realmente las necesites. Cada resultado también lleva el registro original como structuredContent para los clientes que leen la salida estructurada de las herramientas.

Proveedores

providers fija de dónde provienen los datos. Omítelo para distribuir a todos y quedarte con la primera coincidencia.

Proveedor	Te da	Dónde
`fanza`, `dmm`	Metadatos (también búsqueda de texto libre)	search + movie
`javdb`	Enlaces de descarga e imanes	solo movie
`missav`	URLs de stream `.m3u8`	search + movie
`javdatabase`	Descripción e imágenes de muestra	search + movie

Flujo de trabajo

Primero busca, luego detalla — el patrón resolve → fetch:

javinfo-search con q: "AVSA" (o un nombre de actriz) → lista de coincidencias con sus DVD id.
javinfo-movie con q: "AVSA-210" → registro completo. Fija providers: "javdb" para imanes, "missav" para streams.

Desarrollo local

Ejecuta el servidor desde el código fuente con el MCP Inspector:

npm install
npm run build
JAVINFO_API_KEY=jvi_your_key_here npx @modelcontextprotocol/inspector node dist/index.js

¿Prefieres llamar a la API directamente? Omite el servidor y usa los endpoints REST.

Hazla tuya

Este servidor es de código abierto (MIT). ¿Nos hemos saltado una función que quieres? Personalízalo. Las pull requests son bienvenidas, o haz un fork y conviértelo en tuyo. Coge el código fuente: github.com/javinfo/mcp.

Servidor MCP

On this page