Serveur MCP

Donnez à un assistant IA un accès javinfo en direct avec @javinfo/mcp — un serveur MCP stdio exposant la recherche et la consultation de films comme outils.

@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 peut chercher des titres et récupérer lui-même 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 la variable d'environnement JAVINFO_API_KEY. Obtenez-en une depuis le tableau de bord — voir Authentification.

Ajoutez-la à la configuration MCP de votre client. C'est la forme mcpServers standard (Claude Desktop, Cursor, VS Code et Claude Code l'utilisent tous) :

mcp.json

{
  "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 publiée — 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 du client. 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, conçus pour s'enchaîner : chercher pour trouver le code DVD exact, puis récupérer 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 nom d'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 son DVD id exact (celui obtenu lors 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 par défaut pour garder des réponses légères en tokens — définissez includeImages: true quand vous en avez vraiment besoin. Chaque résultat porte aussi la fiche brute sous forme de structuredContent pour les clients qui lisent la sortie structurée des outils.

Fournisseurs

providers épingle d'où viennent les données. Omettez-le pour diffuser vers tous et prendre la première correspondance.

Fournisseur	Vous donne	Où
`fanza`, `dmm`	Métadonnées (fait aussi de la 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 d'abord, puis détaillez — le motif resolve → fetch :

javinfo-search avec q: "AVSA" (ou un nom d'actrice) → liste de correspondances avec leurs DVD id.
javinfo-movie avec q: "AVSA-210" → fiche complète. Épinglez providers: "javdb" pour les aimants, "missav" pour les flux.

Développement local

Exécutez le serveur 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.js

Vous préférez appeler l'API directement ? Sautez le serveur et utilisez les endpoints REST.

Faites-la vôtre

Ce serveur est open source (MIT). Une fonctionnalité vous manque ? Personnalisez-le. Les pull requests sont les bienvenues, ou fork-le et faites-en le vôtre. Prenez le code source : github.com/javinfo/mcp.

Serveur MCP

On this page