AniList MCP (Convex)

AniList를 위한 개인 MCP 서버입니다. Convex가 MCP를 노출하며 https://<déploiement>.convex.site/mcp — 로컬 Node 프로세스나 OAuth 백엔드가 없습니다.

AniList는 GraphQL 엔드포인트(https://graphql.anilist.co) 하나와 implicit grant만 제공합니다. 클라이언트를 만들고 1년 동안 유효한 JWT를 받아서 Convex 환경 변수로 저장하면 됩니다. 이것이 단일 사용자용 지름길입니다.

도구 다섯 가지

마지막 도구는 손으로 관리하는 목록이 아니라 AniList의 일정(airingAt)을 사용합니다. "오늘 밤 뭐 볼까"는 오늘 방영된 에피소드가 됩니다.

Related MCP server: MAL User MCP Server

1. Convex

npm install
npx convex dev

이 명령은 당신의 Convex 계정에 프로젝트를 생성(또는 연결)하고 함수를 배포합니다. 사이트의 HTTP URL은 대시보드에 표시됩니다 (*.convex.site).

2. AniList 토큰 (implicit grant)

1. anilist.co/settings/login → Create New Client

2. Redirect URL: https://anilist.co/api/v2/oauth/pin (PIN 페이지, 백엔드 없음)

3. 열기:

https://anilist.co/api/v2/oauth/authorize?client_id=TON_CLIENT_ID&response_type=token

4. JWT를 복사한 후:

npx convex env set ANILIST_TOKEN 'eyJ...'
npx convex env set ANILIST_TIMEZONE Europe/Paris

선택적으로, POST /mcp를 잠그려면:

npx convex env set MCP_SECRET 'un-secret-long'

3. Cursor

~/.cursor/mcp.json (또는 설정 → MCP) 안에:

{
  "mcpServers": {
    "anilist": {
      "url": "https://VOTRE_DEPLOIEMENT.convex.site/mcp"
    }
  }
}

MCP_SECRET이 정의되어 있다면:

{
  "mcpServers": {
    "anilist": {
      "url": "https://VOTRE_DEPLOIEMENT.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer un-secret-long"
      }
    }
  }
}

전송 방식은 Streamable HTTP이며 세션 유지 기능은 없습니다 (최신 스펙). Convex가 호스트로 남아 있습니다.

예시

• « Frieren 검색 » → chercher → ID + 28개 에피소드

• « Frieren의 12화를 기록 » → progression

• « 85점과 COMPLETED로 기록 » → noter

• « 내 목록에서 오늘 밤에 방영되는 것은? » → en_cours_de_diffusion

개발

npm test
npm run lint
npx convex dev          # watch + push (dev uniquement)

npx convex deploy는 프로덕션 전용입니다.

AniList 호출은 Convex actions입니다 (convex/anilist.ts). HTTP 라우터(convex/http.ts)가 JSON-RPC MCP를 이러한 actions로 변환합니다.