Ani MCP

🎌 ani-mcp

🧠 一个面向 AniList 的智能 MCP 服务器——它懂你的动漫与漫画品味，而不只是简单地调用 API。

✨ 主要特性

大多数 AniList 集成只是 1:1 地映射 API，而 ani-mcp 在其之上增加了一层智能化能力：

• 🎭 品味画像（Taste profiling）——根据你的"已完成"列表构建你的偏好模型
• 🎯 个性化推荐——基于你的品味、心情和当季新番给出"接下来该看什么？"
• 🤝 契合度对比——比较两位用户之间的品味契合度
• 📺 续作提醒——找出你已看过的番在本季播出的续作
• 🔗 观看顺序——为长篇系列进行系列关联链遍历
• ⏱️ 观影规划——"我有 90 分钟，该看点什么？"，从你当前列表中挑选
• 📊 年度回顾——把你的观影/阅读数据汇总成年度报告

此外还包含基础功能：搜索、详情、热门趋势、当季浏览、列表管理、社交功能以及社区推荐。所有搜索与浏览工具都支持分页，可翻看超出第一页的结果。

🚀 快速开始

无需账号，支持任何兼容 MCP 的客户端。

🖥️ Claude Desktop

添加到你的配置文件（可通过 Settings > Developer > Edit Config 打开，macOS 上路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

保存后重启 Claude Desktop 即可。

或者，从 最新发布 下载 ani-mcp.mcpb，通过 Settings > Extensions 安装。

⌨️ Claude Code

claude mcp add ani-mcp -- npx -y ani-mcp

🎯 个性化功能

添加你的用户名以启用推荐、品味画像和列表管理功能：

{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "ani-mcp"],
      "env": {
        "ANILIST_USERNAME": "your_username"
      }
    }
  }
}

如需写操作（更新进度、评分、编辑列表），还需添加 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 接受一个自由格式的 mood 字符串。内置关键字包括：dark、chill、hype、action、romantic、funny、brainy、sad、scary、epic、wholesome、intense、mystery、fantasy、scifi、trippy、nostalgic、artistic、competitive、cozy。

如需添加或覆盖关键字，请将 ANILIST_MOOD_CONFIG 设置为一个 JSON 对象：

{
  "ANILIST_MOOD_CONFIG": "{\"cozy\":{\"boost\":[\"Slice of Life\",\"Iyashikei\"],\"penalize\":[\"Horror\"]},\"mykeyword\":{\"boost\":[\"Romance\"],\"penalize\":[]}}"
}

每个键是一个情绪关键字，映射到 { boost: string[], penalize: string[] }，其中为 AniList 类型与标签的数组。

🔒 隐私

详情请参见 PRIVACY.md。简而言之：ani-mcp 在本地运行，仅向 AniList API 发送请求，不存储任何内容，也不收集任何分析数据。

🐳 Docker

docker build -t ani-mcp .
docker run -e ANILIST_USERNAME=your_username ani-mcp

默认以 HTTP Stream 传输方式在 3000 端口运行。

🔨 从源码构建

git clone https://github.com/gavxm/ani-mcp.git
cd ani-mcp
npm install
npm run build
npm test

🐛 支持

Bug 反馈与功能请求：GitHub Issues

📄 许可证

MIT