MCP サーバー

@javinfo/mcp で AI アシスタントに javinfo へのライブアクセスを — 検索と映画ルックアップをツールとして公開する stdio MCP サーバー。

@javinfo/mcp は、javinfo API をラップする Model Context Protocol サーバー（stdio）です。任意の MCP クライアント — Claude Desktop、Claude Code、Cursor、VS Code — に向けるだけで、アシスタントが自分で作品を検索し、完全なレコードを取得できます。REST API と同じデータを、グルーコードなしで。

セットアップ

サーバーには JAVINFO_API_KEY 環境変数に jvi_ キーが必要です。ダッシュボードから取得してください — 認証を参照。

クライアントの MCP 設定に追加します。これは標準の mcpServers の形です（Claude Desktop、Cursor、VS Code、Claude Code すべてが使います）：

mcp.json

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

npx -y は最新の公開バージョンを取得して実行します — グローバルインストールは不要。クライアントを再起動すると javinfo-search / javinfo-movie ツールが現れます。

キーはクライアント設定に平文で保存されます。そのファイルは非公開にしてください — REST API と同じく、成功した検索ごとに課金されます。レート制限と料金を参照。

ツール

チェーンで使うことを想定した2つのツール：検索で正確な DVD 品番を見つけ、その後でその完全なレコードを取得します。

`javinfo-search`

DVD 品番、タイトル、または女優名で検索します。コンパクトな一致リストを返します。

引数	型	備考
`q`	string、必須	品番、タイトル、または女優名 — 例：`AVSA-210`。
`providers`	string または array、任意	ソースを制限。`fanza`、`dmm`、`missav`、`javdatabase`。デフォルトはすべて。

javdb はここでは利用できません（品番専用）— ダウンロードリンクには javinfo-movie を使ってください。

`javinfo-movie`

正確な DVD id（検索で得たもの）で完全なレコードを1件取得します。

引数	型	備考
`q`	string、必須	正確な DVD id — 例：`AVSA-210`。
`providers`	string または array、任意	`fanza`、`dmm`、`javdb`、`missav`、`javdatabase`。デフォルトはすべて。
`includeImages`	boolean、任意	ジャケット、サンプル、ギャラリーの URL を追加。デフォルト `false`。

画像 URL はトークンを節約するためデフォルトで省略されます — 実際に必要なときだけ includeImages: true を設定してください。すべての結果は、構造化ツール出力を読むクライアント向けに、生レコードも structuredContent として保持します。

プロバイダー

providers はデータの出所をピン留めします。省略するとすべてにファンアウトして最初のヒットを取ります。

プロバイダー	提供するもの	場所
`fanza`、`dmm`	メタデータ（フリーテキスト検索も可）	search + movie
`javdb`	ダウンロードリンクとマグネット	movie のみ
`missav`	`.m3u8` ストリーム URL	search + movie
`javdatabase`	説明文とサンプル画像	search + movie

ワークフロー

まず検索、それから詳細 — resolve → fetch パターン：

q: "AVSA"（または女優名）で javinfo-search → DVD id 付きの一致リスト。
q: "AVSA-210" で javinfo-movie → 完全なレコード。マグネットは providers: "javdb"、ストリームは "missav" をピン留め。

ローカル開発

MCP Inspector でソースからサーバーを実行：

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

API を直接呼びたい？サーバーを飛ばして REST エンドポイントをどうぞ。

自分仕様に

このサーバーはオープンソース（MIT）です。欲しい機能がありませんか？自由にカスタマイズしてください。Pull Request は歓迎しますし、フォークして自分だけのものにするのもアリです。ソースコードをどうぞ： github.com/javinfo/mcp。

MCP サーバー

On this page