ani-mcp 是一个面向 AniList 的 MCP 服务器，定位为“懂你口味的智能层”，而非简单镜像 AniList API。它通过分析用户已完成列表来构建口味画像，并在此基础上提供个性化推荐、观看分析、社交工具和完整的列表管理。
主要能力
- 口味画像：根据已完成列表建立偏好模型。
- 个性化推荐：回答“接下来看什么？”，结合口味、心情和当季阵容给出建议。
- 兼容性对比：比较两个用户的口味。
- 续作提醒：找出你已看完作品在本季播出的续作。
- 观看顺序：遍历系列关系图，为长篇系列生成编号观看顺序。
- 会话规划：例如“我有 90 分钟，该看什么？”，从当前列表中挑选最匹配的剧集填充时间预算。
- 年度回顾：汇总某年的观看/阅读统计。
- 基础功能：搜索、详情、趋势、季度浏览、列表管理、社交功能和社区推荐；所有搜索与浏览工具支持分页。
使用方式 无需账号，兼容任意 MCP 客户端。可在配置文件中添加（Settings > Developer > Edit Config，macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json），保存后重启 Claude Desktop；也可从最新 release 下载 ani-mcp.mcpb，通过 Settings > Extensions 安装。
个性化功能需添加用户名以启用推荐、口味画像和列表管理；写操作（更新进度、评分、编辑列表）还需添加 ANILIST_TOKEN。
环境变量
- 搜索与发现
- 写操作（需要 ANILIST_TOKEN）
MCP 资源可在无需工具调用的情况下为 AI 助手提供上下文，支持资源的客户端可自动将其纳入对话。还提供预置对话开场白，客户端可作为快捷操作提供。
连接 ani-mcp 后可向 AI 助手提出的示例问题
- “接下来看什么？”：使用 anilist_pick 分析已完成列表、构建口味画像，并从计划列表中按匹配度推荐。
- “我想要黑暗心理向的”：使用 anilist_pick 的心情筛选，提升匹配该氛围的作品并降低不匹配项。
- “本季有什么好番？”：使用 anilist_pick 并设置 source: SEASONAL，按口味画像对当季动画排名。
- “我有 90 分钟，今晚看什么？”：使用 anilist_session 从正在观看列表挑选并填充时间预算。
- “我追完的番有续作在播吗？”：使用 anilist_sequels 交叉比对已完成列表与本季阵容。
- “Fate 该按什么顺序看？”：使用 anilist_watch_order 遍历系列关系图生成编号观看顺序。
- “把我的口味和 username123 对比”：使用 anilist_compare 找出共同作品、计算兼容性分数并突出最大分歧。
- “我为什么会喜欢《冰海战记》？”：使用 anilist_explain 按口味画像评分，拆解类型亲和度与主题契合度。
- “展示我的动画年度回顾”：使用 anilist_wrapped 汇总某年观看内容。
anilist_pick 和 anilist_session 接受自由文本心情字符串。内置关键词包括：dark、chill、hype、action、romantic、funny、brainy、sad、scary、epic、wholesome、intense、mystery、fantasy、scifi、trippy、nostalgic、artistic、competitive、cozy。可通过设置 ANILIST_MOOD_CONFIG 为 JSON 对象来添加或覆盖关键词，每个键为心情关键词，映射到 { boost: string[], penalize: string[] }，即 AniList 类型与标签的数组。
隐私与运行 ani-mcp 本地运行，仅向 AniList API 发送请求，不存储任何内容，不收集分析数据。默认使用 HTTP Stream 传输，运行在 3000 端口。
其他 支持从源码构建。Bug 报告与功能请求可通过 GitHub Issues 提交。
