MCP 服务器

使用 @javinfo/mcp 为 AI 助手提供 javinfo 实时访问 — 一个 stdio MCP 服务器，将搜索和影片查询作为工具公开。

@javinfo/mcp 是一个模型上下文协议（Model Context Protocol）服务器（stdio），封装了 javinfo API。将它指向任何 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 一样按成功查询计费。参见速率限制与计费。

工具

两个工具，意在串联使用：先搜索找到确切的 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

工作流

先搜索，再获取详情 — 解析 → 获取的模式：

使用 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，或者 fork 后打造您自己的版本。直接拿走源代码： github.com/javinfo/mcp。

MCP 服务器

On this page