MCP server
Live javinfo access for AI assistants, as a stdio MCP server exposing search and movie lookup.
@javinfo/mcp is a
Model Context Protocol server (stdio) that wraps the
javinfo API. Point any MCP client (Claude Desktop, Claude Code, Cursor, VS Code) at it and the
assistant searches titles and pulls full records: same data as the
REST API, no glue code.
Setup
The server needs your jvi_ key in JAVINFO_API_KEY. Get one from your
dashboard; see Authentication.
Add it to your client's MCP config, the standard mcpServers shape (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 fetches and runs the latest version, no global install. Restart the client and the
javinfo-search / javinfo-movie tools appear.
The key sits in plaintext in the client config. Keep that file private: it bills per successful lookup, like the REST API. See Rate limits & billing.
Tools
Two tools, made to chain: search for the DVD code, then fetch the record.
javinfo-search
Search by DVD code, title, or actress. Returns a compact list of matches.
| Argument | Type | Notes |
|---|---|---|
q | string, required | Code, title or actress, e.g. AVSA-210. |
providers | string or array, optional | Restrict sources. fanza, dmm, missav, javdatabase. Defaults to all. |
javdb is not available here (code-only); use javinfo-movie for download links.
javinfo-movie
Fetch one full record by exact DVD id, as returned by search.
| Argument | Type | Notes |
|---|---|---|
q | string, required | Exact DVD id, e.g. AVSA-210. |
providers | string or array, optional | fanza, dmm, javdb, missav, javdatabase. Defaults to all. |
includeImages | boolean, optional | Append jacket, sample and gallery URLs. Default false. |
Image URLs are omitted to keep responses lean; set includeImages: true when needed.
Every result also carries the raw record as structuredContent for clients that read
structured output.
Providers
providers pins the source. Omit it to fan out and take the first hit.
| Provider | Gives you | Where |
|---|---|---|
fanza, dmm | Metadata (and free-text search) | search + movie |
javdb | Download links and magnets | movie only |
missav | .m3u8 stream URLs | search + movie |
javdatabase | Description and sample images | search + movie |
Workflow
Search, then fetch:
javinfo-searchwithq: "AVSA"(or an actress) → matches with DVD ids.javinfo-moviewithq: "AVSA-210"→ full record. Pinproviders: "javdb"for magnets,"missav"for streams.
Local dev
Run from source against the MCP Inspector:
npm install
npm run build
JAVINFO_API_KEY=jvi_your_key_here npx @modelcontextprotocol/inspector node dist/index.jsPrefer the API directly? Hit the REST endpoints.
Make it yours
Open source (MIT). Want a missing feature? Pull requests welcome, or fork it. Source: github.com/javinfo/mcp.