Máy chủ MCP

Cấp cho trợ lý AI quyền truy cập javinfo trực tiếp bằng @javinfo/mcp — một máy chủ MCP stdio cung cấp tìm kiếm và tra cứu phim dưới dạng công cụ.

@javinfo/mcp là một máy chủ Model Context Protocol (stdio) bao bọc API javinfo. Trỏ bất kỳ máy khách MCP nào — Claude Desktop, Claude Code, Cursor, VS Code — vào nó là trợ lý có thể tự tìm kiếm tựa đề và lấy toàn bộ hồ sơ. Cùng dữ liệu như REST API, không cần mã keo dính.

Thiết lập

Máy chủ cần khóa jvi_ của bạn trong biến môi trường JAVINFO_API_KEY. Lấy một khóa từ bảng điều khiển — xem Xác thực.

Thêm nó vào cấu hình MCP của máy khách. Đây là cấu trúc mcpServers chuẩn (Claude Desktop, Cursor, VS Code, Claude Code đều dùng):

mcp.json

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

npx -y tải về và chạy phiên bản mới nhất đã phát hành — không cần cài đặt toàn cục. Khởi động lại máy khách là các công cụ javinfo-search / javinfo-movie xuất hiện.

Khóa nằm ở dạng văn bản thuần trong cấu hình máy khách. Hãy giữ tệp đó riêng tư — nó tính phí cho mỗi lần tra cứu thành công, giống như REST API. Xem Giới hạn tốc độ & thanh toán.

Công cụ

Hai công cụ, được thiết kế để xâu chuỗi: tìm kiếm để xác định mã DVD chính xác, rồi lấy toàn bộ hồ sơ của nó.

`javinfo-search`

Tìm kiếm theo mã DVD, tiêu đề hoặc diễn viên. Trả về danh sách kết quả khớp gọn gàng.

Đối số	Loại	Ghi chú
`q`	string, bắt buộc	Mã, tiêu đề hoặc tên diễn viên — ví dụ `AVSA-210`.
`providers`	string hoặc array, tùy chọn	Giới hạn nguồn. `fanza`, `dmm`, `missav`, `javdatabase`. Mặc định là tất cả.

javdb không khả dụng ở đây (chỉ dùng mã) — hãy dùng javinfo-movie cho các liên kết tải xuống.

`javinfo-movie`

Lấy một hồ sơ đầy đủ theo đúng DVD id (cái bạn có được từ tìm kiếm).

Đối số	Loại	Ghi chú
`q`	string, bắt buộc	DVD id chính xác — ví dụ `AVSA-210`.
`providers`	string hoặc array, tùy chọn	`fanza`, `dmm`, `javdb`, `missav`, `javdatabase`. Mặc định là tất cả.
`includeImages`	boolean, tùy chọn	Thêm URL ảnh bìa, ảnh mẫu và bộ sưu tập. Mặc định `false`.

URL hình ảnh bị bỏ qua theo mặc định để giữ phản hồi gọn về token — đặt includeImages: true khi bạn thực sự cần. Mọi kết quả cũng mang bản ghi thô dưới dạng structuredContent cho các máy khách đọc đầu ra công cụ có cấu trúc.

Nhà cung cấp

providers ghim nơi dữ liệu đến. Bỏ qua nó để fan-out tới tất cả và lấy kết quả trúng đầu tiên.

Nhà cung cấp	Cung cấp cho bạn	Nơi
`fanza`, `dmm`	Metadata (cũng có tìm kiếm văn bản tự do)	search + movie
`javdb`	Liên kết tải xuống và magnet	chỉ movie
`missav`	URL stream `.m3u8`	search + movie
`javdatabase`	Mô tả và ảnh mẫu	search + movie

Quy trình

Tìm kiếm trước, rồi chi tiết — mô hình resolve → fetch:

javinfo-search với q: "AVSA" (hoặc tên diễn viên) → danh sách kết quả khớp kèm DVD id.
javinfo-movie với q: "AVSA-210" → hồ sơ đầy đủ. Ghim providers: "javdb" cho magnet, "missav" cho stream.

Phát triển cục bộ

Chạy máy chủ từ mã nguồn với MCP Inspector:

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

Muốn gọi API trực tiếp hơn? Bỏ qua máy chủ và dùng các endpoint REST.

Tùy biến theo cách của bạn

Máy chủ là mã nguồn mở (MIT). Chúng tôi bỏ sót tính năng bạn muốn? Hãy tùy biến nó. Pull request luôn được chào đón, hoặc fork nó và biến nó thành của riêng bạn. Cứ lấy mã nguồn: github.com/javinfo/mcp.

Máy chủ MCP

On this page