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 一样按成功查询计费。见 速率限制与计费。
工具
两个工具配合使用：先搜到 DVD 番号，再取完整记录。
javinfo-search
按 DVD 番号、标题或演员搜索，返回紧凑的匹配列表。
| 参数 | 类型 | 说明 |
|---|---|---|
q | string，必填 | 番号、标题或演员，如 AVSA-210。 |
providers | string 或 array，可选 | 限制来源。fanza、dmm、missav、javdatabase。默认全部。 |
javdb 在此不可用（仅支持番号）；下载链接用 javinfo-movie。
javinfo-movie
按搜索返回的确切 DVD id 获取完整记录。
| 参数 | 类型 | 说明 |
|---|---|---|
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.js想直接调 API？访问 REST 端点。
让它成为你的
开源（MIT）。缺你想要的功能？欢迎 Pull Request，或 fork 自建。源码： github.com/javinfo/mcp。