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는 출처를 고정합니다. 생략하면 전체로 fan-out해 첫 결과를 가져옵니다.
| 제공업체 | 제공 항목 | 위치 |
|---|---|---|
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.