AniList MCP (Convex)

用于 AniList 的个人 MCP 服务器。Convex 将 MCP 暴露在 https://<déploiement>.convex.site/mcp——没有本地 Node 进程，没有 OAuth 后端。

AniList 只有一个 GraphQL 端点（https://graphql.anilist.co）和一种隐式授权（implicit grant）：你创建一个客户端，获取一个有效期一年的 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 令牌（隐式授权）

1. anilist.co/settings/developer → 创建新客户端

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 操作（convex/anilist.ts）。HTTP 路由器（convex/http.ts）将 MCP JSON-RPC 转换为这些操作。