Máy chủ MCP
Truy cập javinfo trực tiếp cho trợ lý AI: máy chủ MCP stdio với tìm kiếm và tra cứu phim.
@javinfo/mcp là 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ý
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.
Thiết lập
Máy chủ cần khóa jvi_ trong JAVINFO_API_KEY. Lấy khóa từ
bảng điều khiển; xem Xác thực.
Thêm vào cấu hình MCP của máy khách, cấu trúc mcpServers chuẩn (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 tải và chạy phiên bản mới nhất, không cần cài toàn cục. Khởi động lại máy khách
là 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. Giữ tệp đó riêng tư: nó tính phí mỗi lần tra cứu thành công, như REST API. Xem Giới hạn tốc độ & thanh toán.
Công cụ
Hai công cụ để xâu chuỗi: tìm mã DVD, rồi lấy toàn bộ hồ sơ.
javinfo-search
Tìm theo mã DVD, tiêu đề hoặc diễn viên; trả về danh sách khớp gọn.
| Đối số | Loại | Ghi chú |
|---|---|---|
q | string, bắt buộc | Mã, tiêu đề hoặc 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 tất cả. |
javdb không khả dụng ở đây (chỉ dùng mã); dùng javinfo-movie cho liên kết tải
xuống.
javinfo-movie
Lấy một hồ sơ đầy đủ theo đúng DVD id 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 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 để phản hồi gọn; đặ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ó cấu trúc.
Nhà cung cấp
providers ghim nguồn dữ liệu. Bỏ qua để fan-out tới tất cả và lấy kết quả trúng đầu.
| Nhà cung cấp | Cung cấp | Nơi |
|---|---|---|
fanza, dmm | Metadata (và 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 trước, rồi lấy chi tiết:
javinfo-searchvớiq: "AVSA"(hoặc diễn viên) → kết quả khớp kèm DVD id.javinfo-movievớiq: "AVSA-210"→ hồ sơ đầy đủ. Ghimproviders: "javdb"cho magnet,"missav"cho stream.
Phát triển cục bộ
Chạy 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.jsMuốn gọi API trực tiếp? Dùng các endpoint REST.
Tùy biến theo cách của bạn
Mã nguồn mở (MIT). Thiếu tính năng bạn muốn? Pull request luôn được chào đón, hoặc fork. Mã nguồn: github.com/javinfo/mcp.