Servidor MCP
Acceso en vivo a javinfo para asistentes de IA: servidor MCP stdio con búsqueda y consulta de películas.
@javinfo/mcp es un servidor
Model Context Protocol (stdio) que envuelve la API de
javinfo. Apunta cualquier cliente MCP (Claude Desktop, Claude Code, Cursor, VS Code) y el
asistente busca títulos y obtiene registros completos: los mismos datos que la
API REST, sin código de pegamento.
Configuración
El servidor necesita tu clave jvi_ en JAVINFO_API_KEY. Obtén una en el
panel de control; consulta Autenticación.
Añádela a la configuración MCP del cliente, forma mcpServers estándar (Claude Desktop,
Cursor, VS Code, Claude Code):
{
"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, sin instalación global. Reinicia el cliente y
aparecen javinfo-search / javinfo-movie.
La clave queda en texto plano en la configuración. Mantén el archivo privado: se factura por cada búsqueda correcta, como la API REST. Consulta límites de tasa y facturación.
Herramientas
Dos herramientas para encadenar: busca el código DVD y obtén su registro completo.
javinfo-search
Busca por código DVD, título o actriz; devuelve coincidencias compactas.
| Argumento | Tipo | Notas |
|---|---|---|
q | string, obligatorio | Código, título o actriz, p. ej. AVSA-210. |
providers | string o array, opcional | Restringir fuentes. fanza, dmm, missav, javdatabase. Por defecto todas. |
javdb no está aquí (solo por código); usa javinfo-movie para enlaces de descarga.
javinfo-movie
Obtiene un registro completo por DVD id exacto de 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 para respuestas ligeras; activa includeImages: true cuando
las necesites. Cada resultado lleva el registro original como structuredContent para
clientes que leen la salida estructurada.
Proveedores
providers fija el origen. Omítelo para distribuir a todos y tomar el primer acierto.
| Proveedor | Te da | Dónde |
|---|---|---|
fanza, dmm | Metadatos (y 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
Busca y luego detalla:
javinfo-searchconq: "AVSA"(o una actriz) → coincidencias con DVD id.javinfo-movieconq: "AVSA-210"→ registro completo. Fijaproviders: "javdb"para imanes,"missav"para streams.
Desarrollo local
Ejecuta 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 la API? Usa los endpoints REST.
Hazla tuya
Código abierto (MIT). ¿Falta una función? Pull requests bienvenidas, o haz un fork. Código: github.com/javinfo/mcp.