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 모두 사용):

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는 데이터 출처를 고정합니다. 생략하면 전체로 fan-out하여 첫 번째 결과를 가져옵니다.

제공업체	제공 항목	위치
`fanza`, `dmm`	메타데이터(자유 텍스트 검색도 가능)	search + movie
`javdb`	다운로드 링크 및 마그넷	movie 전용
`missav`	`.m3u8` 스트림 URL	search + movie
`javdatabase`	설명 및 샘플 이미지	search + movie

워크플로

먼저 검색하고, 그다음 세부 정보 — resolve → fetch 패턴:

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