AniList MCP 服务器

你是否曾经在聊天时突然想不起来某个动漫的主角叫什么名字？或者想推荐一部“类似《孤独摇滚！》”的番剧给朋友，却需要手动去 AniList 搜索？对于动漫和漫画爱好者来说，快速获取作品、角色、声优信息是一种常见需求。

这就是 anilist-mcp 要解决的问题。它是一个基于模型上下文协议的服务器，通过连接 AniList 的 GraphQL API，让 AI 助手能够搜索、查询和交互海量的动漫、漫画、角色、制作人员以及用户数据。

项目基本信息

一、项目介绍

anilist-mcp 是一个功能全面的 MCP 服务器，它封装了 AniList 的数据接口。AniList 是一个流行的动漫和漫画数据库，用户可以在这里追踪观看进度、评分、评论，并与他人分享。

该服务器提供了超过 40 种工具，覆盖了以下主要类别：

• 搜索功能：你可以搜索动漫、漫画、角色、制作人员、工作室、用户、活动等。
• 媒体详情：获取特定动漫或漫画的详细信息，包括描述、集数、评分、标签、声优等。
• 用户交互：[需要登录] 获取用户列表、关注用户、添加/更新列表条目、发帖等。
• 角色与人员：查询角色或制作人员的生日、作品等。
• 推荐系统：获取媒体推荐。

它支持 STDIO 和 HTTP 两种传输方式，既可以作为本地集成，也可以部署为云端服务。

二、核心优势

极为丰富的工具数量
超过 40 个工具，覆盖了 AniList API 的绝大部分功能。从简单的搜索到复杂的列表管理，几乎任何你能在 AniList 网站上做的操作，都能通过 AI 对话完成。

双重传输模式
支持 STDIO（标准输入输出）用于与 Claude Desktop 等本地客户端集成，也支持 HTTP 模式用于远程部署。这让你可以将服务器作为微服务，供多个客户端共享。

支持登录操作
通过可选的 AniList API 令牌，你可以执行需要身份验证的操作，例如更新自己的动漫列表、关注其他用户、发布活动等。令牌通过环境变量或 HTTP 头传递。

完善的云部署支持
项目支持 Smithery 等 MCP 部署平台，并提供了 Docker 镜像（发布到 GitHub Container Registry）。你可以轻松地将其部署到任何支持 Node.js 的云环境。

类型安全与良好维护
项目使用 TypeScript 编写，类型定义完整。版本已迭代到 1.4.0，有持续的更新和维护记录。

三、适用场景

个人动漫助手
你可以直接问：“帮我查一下《葬送的芙莉莲》的制作公司。” “搜索评分高于 8.5 的、类型为‘治愈’的动漫。”

列表管理与追踪
如果你登录了 AniList，可以让 AI 帮你：“把我 Plan to Watch 列表中的《间谍过家家》移动到 Watching。” “记录一下我刚看完《咒术回战》第 2 季第 5 集。”

角色与声优查询
“今天有哪些动漫角色的生日？” “找一下由‘种崎敦美’配音的角色。”

社群互动
“获取我的用户活动动态。” “在好友的帖子下回复：‘我也喜欢这部作品！’”

推荐引擎
“给我推荐 10 部类似于《钢之炼金术师》的动漫。”

四、安装教程

安装 anilist-mcp 非常简单，推荐使用 npx 直接运行，无需克隆仓库。

第一步：获取 AniList API 令牌（可选）

如果你只需要查询公开数据（搜索、查看详情），则不需要令牌。如果你需要执行写入操作（更新列表、发帖、关注等），则需要令牌。

1. 访问 AniList 设置页面。
2. 点击“创建新客户端”。
3. 将重定向 URL 设置为 https://anilist.co/api/v2/oauth/pin。
4. 创建后，使用客户端 ID 访问以下 URL（将 {clientID} 替换为你的 ID）: https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token。
5. 登录授权后，你会获得一个令牌。

第二步：配置 MCP 客户端

对于 Claude Desktop，编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %AppData%\Claude\claude_desktop_config.json），添加以下内容。

选项 A：仅公开数据查询（无需令牌）

{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "anilist-mcp"]
    }
  }
}

选项 B：需要认证操作（提供令牌）

{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "anilist-mcp"],
      "env": {
        "ANILIST_TOKEN": "你的令牌"
      }
    }
  }
}

第三步：重启客户端

保存配置，完全退出并重启 Claude Desktop。

验证安装

重启后，你可以问 Claude：“搜索一下动漫‘间谍过家家’。” 如果它能够返回结果，说明安装成功。

五、使用示例

以下是在配置好服务器后，与 AI 的自然语言对话示例。假设你已经配置了令牌（如果需要）。

示例1：搜索动漫

用户输入：搜索与“魔法”相关的动漫，按评分排序。

AI 会调用 search_anime 工具，参数为 search: "魔法"，可能还会加上 sort: ["SCORE_DESC"]。然后返回一个动漫列表。

示例2：获取角色今日生日

用户输入：今天是哪几位动漫角色的生日？

AI 会调用 get_todays_birthday_characters，返回所有生日为今天的角色，包括角色名称和作品。

示例3：获取用户列表（无需登录）

用户输入：查看用户 'yuna0x0' 的动漫列表。

AI 会调用 get_user_anime_list，参数为 username: "yuna0x0"，返回该用户的动漫列表状态（已看、想看等）。

示例4：更新自己的列表（需要登录）

用户输入：把《孤独摇滚！》这部动漫添加到我的“已看”列表，评分 10，进度 12/12。

AI 会先搜索《孤独摇滚！》获取其 ID，然后调用 add_list_entry 或 update_list_entry 工具，设置 status: "COMPLETED", score: 10, progress: 12。

示例5：获取工作室的作品

用户输入：京阿尼（Kyoto Animation）制作了哪些动漫？

AI 会调用 search_studio 找到京阿尼的 ID，然后调用 get_studio，或者直接通过 get_anime 组合查询，返回该工作室的作品列表。

六、常见问题

问题1：服务器工具数量太多，会不会让 AI 难以选择？

解决方案：这是一个合理的担忧。但现代的 AI 模型能够根据你的自然语言描述，准确地从 40 多个工具中选择最合适的一个。例如，当你说“搜索”时，AI 会倾向于使用 search_xxx 类工具。工具的命名也非常直观。

问题2：为什么有些操作提示“需要登录”？

解决方案：这些操作（如更新列表、发布活动）需要代表你的用户身份执行，因此需要 AniList API 令牌。请按照上述步骤获取令牌并配置在 env 中。

问题3：HTTP 传输模式是什么？我应该用哪个？

解决方案：如果你只将服务器与 Claude Desktop 等本地客户端一起使用，使用 STDIO（默认）即可。如果你希望将服务器部署在云上，让多个客户端通过网络连接，应使用 HTTP 模式。运行 pnpm run start:http 可以启动 HTTP 服务器。

问题4：某些搜索返回的结果很少或不准确。

解决方案：AniList 的搜索算法可能与你预期不同。尝试使用更精确的关键词，或利用 search_anime 中的 filters 参数（如 genre_in、tag_in）来缩小范围。你也可以在 AniList 网站上直接测试同样的搜索词。

问题5：可以查询成人向内容吗？

解决方案：AniList API 默认会过滤成人内容。根据 API 文档，你可能需要特定的权限或设置才能访问。该服务器可能未实现此功能。

七、总结

anilist-mcp 是一个非常完整且专业的 MCP 服务器，专为动漫和漫画爱好者设计。它几乎暴露了 AniList API 的所有核心功能，并通过 40 多个工具让 AI 能够执行从查询到交互的各种任务。

该项目的亮点包括：

• 功能覆盖全面：从搜索到列表管理，再到社交互动，一应俱全。
• 使用灵活：支持本地和云端部署，支持公开访问和认证操作。
• 维护积极：版本迭代快，有 Docker 镜像和多种发布渠道。
• 开源免费：MIT 许可证，代码开放。

74 颗星反映了它在动漫爱好者社区中的受欢迎程度。对于任何希望将动漫数据集成到 AI 对话中，或者希望打造一个个性化的动漫助手的开发者来说，anilist-mcp 是一个绝佳的起点。