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 共通）：
{
"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 |
ワークフロー
検索してから取得：
javinfo-searchにq: "AVSA"（または女優名）→ DVD id 付きの一致。javinfo-movieにq: "AVSA-210"→ 完全なレコード。マグネットはproviders: "javdb"、ストリームは"missav"。
ローカル開発
MCP Inspector でソースから実行：
npm install
npm run build
JAVINFO_API_KEY=jvi_your_key_here npx @modelcontextprotocol/inspector node dist/index.jsAPI を直接？REST エンドポイント へ。
自分仕様に
オープンソース（MIT）。欲しい機能がなければ Pull Request を、または fork を。ソース： github.com/javinfo/mcp。