Serveur MCP
Accès javinfo en direct pour assistants IA : serveur MCP stdio avec recherche et consultation de films.
@javinfo/mcp est un serveur
Model Context Protocol (stdio) qui enveloppe l'API
javinfo. Pointez n'importe quel client MCP (Claude Desktop, Claude Code, Cursor, VS Code)
dessus et l'assistant cherche des titres et récupère des fiches complètes : les mêmes
données que l'API REST, sans code de collage.
Configuration
Le serveur a besoin de votre clé jvi_ dans JAVINFO_API_KEY. Obtenez-en une depuis le
tableau de bord ; voir Authentification.
Ajoutez-la à la configuration MCP du client, forme mcpServers standard (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 récupère et exécute la dernière version, sans installation globale. Redémarrez le
client et les outils javinfo-search / javinfo-movie apparaissent.
La clé est stockée en clair dans la configuration. Gardez ce fichier privé : elle est facturée à chaque recherche réussie, comme l'API REST. Voir limites de débit et facturation.
Outils
Deux outils à enchaîner : trouvez le code DVD, puis sa fiche complète.
javinfo-search
Recherche par code DVD, titre ou actrice ; renvoie une liste compacte de correspondances.
| Argument | Type | Remarques |
|---|---|---|
q | string, requis | Code, titre ou actrice, p. ex. AVSA-210. |
providers | string ou tableau, facultatif | Restreindre les sources. fanza, dmm, missav, javdatabase. Par défaut : toutes. |
javdb n'est pas disponible ici (réservé aux codes) ; utilisez javinfo-movie pour les
liens de téléchargement.
javinfo-movie
Récupère une fiche complète par DVD id exact issu de la recherche.
| Argument | Type | Remarques |
|---|---|---|
q | string, requis | DVD id exact, p. ex. AVSA-210. |
providers | string ou tableau, facultatif | fanza, dmm, javdb, missav, javdatabase. Par défaut : toutes. |
includeImages | boolean, facultatif | Ajoute les URL de jaquette, d'échantillon et de galerie. Défaut false. |
Les URL d'images sont omises pour des réponses légères ; includeImages: true au besoin. Chaque résultat porte aussi la fiche brute en structuredContent pour les
clients qui lisent la sortie structurée.
Fournisseurs
providers épingle l'origine. Omettez-le pour diffuser vers tous et prendre la première
correspondance.
| Fournisseur | Vous donne | Où |
|---|---|---|
fanza, dmm | Métadonnées (et recherche en texte libre) | search + movie |
javdb | Liens de téléchargement et aimants | movie uniquement |
missav | URLs de flux .m3u8 | search + movie |
javdatabase | Description et images d'exemple | search + movie |
Flux de travail
Cherchez, puis détaillez :
javinfo-searchavecq: "AVSA"(ou une actrice) → correspondances avec DVD id.javinfo-movieavecq: "AVSA-210"→ fiche complète. Épinglezproviders: "javdb"pour les aimants,"missav"pour les flux.
Développement local
Exécutez depuis les sources avec le MCP Inspector :
npm install
npm run build
JAVINFO_API_KEY=jvi_your_key_here npx @modelcontextprotocol/inspector node dist/index.jsVous préférez l'API ? Utilisez les endpoints REST.
Faites-la vôtre
Open source (MIT). Une fonctionnalité manque ? Pull requests ou fork. Code : github.com/javinfo/mcp.