AniList MCP (Convex)

AniList 用の個人 MCP サーバー。Convex が MCP を公開します：https://<déploiement>.convex.site/mcp — ローカルの Node プロセスも、OAuth バックエンドも不要です。

AniList は GraphQL エンドポイントを1つだけ持ち（https://graphql.anilist.co）、implicit grant を使います。クライアントを作成し、1年間有効な JWT を取得して、それを Convex の環境変数に設定するだけ。単一ユーザー向けのショートカットです。

5つのツール

最後のツールは、手動リストではなく 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/developer → 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（または Settings → 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）が MCP の JSON-RPC を、これらのアクションへ変換します。