Skip to main content
Glama
AniList MCP

AniList MCP

by JunnB

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 환경 변수로 저장하면 됩니다. 이것이 단일 사용자용 지름길입니다.

도구 다섯 가지

도구

역할

chercher

제목을 검색하고 AniList ID와 에피소드 수를 반환합니다

ma_liste

상태 필터가 가능한 내 컬렉션 (CURRENT, PLANNING, …)

progression

progress와 함께 SaveMediaListEntry 호출 — 방금 본 에피소드 기록

noter

score와 status를 포함한 SaveMediaListEntry 호출

en_cours_de_diffusion

내가 팔로우하는 시리즈 중 이번 주에 나오는 것

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

Related MCP server: AniList 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
  1. 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로 변환합니다.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables searching and browsing anime/manga, characters, staff, and more on AniList without credentials, and with a one-time login allows managing personal lists, favorites, follows, and activity.
      50
      86 npm
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables querying and updating Bangumi anime collections, tracking per-episode progress, and receiving airing reminders for currently-watching anime via AniList.
      -