安妮-MCP
](https://www.npmjs.com/package/ani-mcp) ](https://www.npmjs.com/package/ani-mcp)   
聪明的 主控程序 服务器 AniList 了解你的动漫和漫画品味,而不仅仅是原始的API调用。
这有什么不同
大多数AniList集成镜像API 1:1。ani-mcp在上面添加了一个智能层:
- 口味分析 -根据您完成的列表构建您的偏好模型
- 个性化挑选 -“接下来我该看什么?”根据你的口味、心情和季节阵容
- 兼容性 -比较两个用户的口味
- 后续警报 -找到本季播出的你已经完成的节目的续集
- 观看订单 -长时间运行系列的特许经营链遍历
- 会议规划 -“我有90分钟,我该看什么?”
- 年度回顾 -您的观看/阅读统计数据已结束
再加上基本要素:搜索、细节、趋势、季节性浏览、列表管理、社交功能和社区推荐。所有搜索和浏览工具都支持分页,以便在结果的第一页之外进行浏览。
30秒后试试
不需要帐户。适用于任何兼容MCP的客户端。
克劳德桌面版
添加到配置文件(Settings > Developer > Edit Config 或 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):
{
"mcpServers": {
"anilist": {
"command": "npx",
"args": ["-y", "ani-mcp"]
}
}
}保存后重新启动Claude Desktop。
或者,下载 ani-mcp.mcpb 从 最新版本 并通过安装 Settings > Extensions.
克劳德代码
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_USERNAME | 否 | 列表和统计工具的默认用户名。也可以通过每次通话。 |
ANILIST_TOKEN | 否 | AniList OAuth令牌。写操作和私有列表需要。 |
ANILIST_TITLE_LANGUAGE | 否 | 标题首选项: english (默认), romaji,或 native. |
ANILIST_SCORE_FORMAT | 否 | 覆盖分数显示: POINT_100, POINT_10_DECIMAL, POINT_10, POINT_5, POINT_3. |
ANILIST_NSFW | 否 | 设置为 true 在结果中包含成人内容。违约: false. |
ANILIST_MOOD_CONFIG | 没有 | JSON对象可以添加或覆盖语气关键字。看 情绪配置. |
DEBUG | 否 | 设置为 true 用于将调试日志记录到stderr。 |
MCP_TRANSPORT | 否 | 设置为 http 用于HTTP流传输。默认值:stdio。 |
MCP_PORT | 没有 | HTTP传输端口。违约: 3000. |
MCP_HOST | 否 | 用于HTTP传输的主机。违约: localhost. |
工具
搜索与发现
| 工具 | 说明 |
|---|---|
anilist_search | 按标题、流派、年份和格式过滤器搜索动漫/漫画 |
anilist_details | 标题的完整细节、关系和建议 |
anilist_seasonal | 浏览一季的动漫阵容 |
anilist_trending | AniList上现在的趋势是什么 |
anilist_genres | 使用可选过滤器浏览流派中的热门标题 |
anilist_genre_list | 列出所有有效的流派和内容标签 |
anilist_recommendations | 社区对特定标题的建议 |
列表和统计信息
| 工具 | 说明 |
|---|---|
anilist_list | 用户的动漫/漫画列表,按状态过滤 |
anilist_lookup | 检查特定标题是否在用户列表中 |
anilist_stats | 观看/阅读统计数据、热门流派、分数分布 |
智能
| 工具 | 说明 |
|---|---|
anilist_taste | 从您完成的列表中生成口味档案 |
anilist_pick | 从您的待办事项列表、季节性阵容或发现池中个性化“下一步要看什么” |
anilist_compare | 比较两个用户之间的口味兼容性 |
anilist_wrapped | 年度回顾总结 |
anilist_explain | “我为什么喜欢这个?”-根据你的品味档案给一个标题打分 |
anilist_similar | 查找与给定动漫或漫画相似的标题 |
anilist_sequels | 本季播出的你已完成的作品的续集 |
anilist_watch_order | 查看特许经营订单 |
anilist_session | 在时间预算内计划查看会话 |
anilist_mal_import | 导入MyAnimeList用户列表并生成推荐 |
anilist_kitsu_import | 导入Kitsu用户列表并生成推荐 |
卡片
| 工具 | 说明 |
|---|---|
anilist_taste_card | 生成可共享的口味档案卡作为PNG图像 |
anilist_compat_card | 生成一张兼容卡,将两个用户作为PNG图像进行比较 |
信息
| 工具 | 说明 |
|---|---|
anilist_staff | 工作人员和配音演员获得一个头衔 |
anilist_staff_search | 按姓名搜索某人并查看其所有作品 |
anilist_studio_search | 搜索工作室并查看他们的作品 |
anilist_schedule | 播出时间表和下一集倒计时 |
anilist_airing | 您当前正在观看的标题的即将播出的剧集 |
anilist_characters | 按名称、外观和VA搜索字符 |
anilist_whoami | 检查身份验证状态和分数格式 |
社交
| 工具 | 说明 |
|---|---|
anilist_profile | 查看用户的个人资料、个人简介、收藏夹和统计数据 |
anilist_feed | 用户提要中的最近活动 |
anilist_reviews | 标题的社区评论 |
anilist_favourite | 在动漫、漫画、角色、工作人员或工作室中切换收藏夹 |
anilist_activity | 在您的订阅源中发布文本活动 |
anilist_group_pick | 寻找动漫/漫画供一组人一起观看 |
anilist_shared_planning | 查找两个用户的计划列表之间的重叠 |
anilist_follow_suggestions | 根据口味兼容性对用户进行排名 |
anilist_react | 喜欢或回复活动 |
分析
| 工具 | 说明 |
|---|---|
anilist_calibration | 按流派评分偏差与社区共识 |
anilist_drops | 跌落模式分析——类型/标签聚类和中值跌落点 |
anilist_evolution | 你的品味如何在2年的时间窗口内转变 |
anilist_completionist | 通过关系图跟踪特许经营完成情况 |
anilist_seasonal_stats | 每个季节的拣选/完成/丢弃率 |
anilist_pace | 当前正在观看的标题的预计完成日期 |
写(必填 ANILIST_TOKEN)
| 工具 | 说明 |
|---|---|
anilist_update_progress | 更新剧集或章节进度 |
anilist_add_to_list | 在列表中添加一个带有状态的标题 |
anilist_rate | 为标题打分(0-10) |
anilist_delete_from_list | 从列表中删除条目 |
anilist_undo | 撤消上次写入操作 |
anilist_unscored | 列出已完成但未评分的标题以进行批量评分 |
anilist_batch_update | 批量筛选+对列表条目的操作(默认的模拟运行) |
资源
MCP资源为您的AI助手提供上下文,而无需调用工具。支持资源的客户端可以在对话中自动包含此信息。
| 资源 | 描述 |
|---|---|
anilist://profile | 您的AniList个人资料,包括个人简介、统计数据和收藏夹 |
anilist://taste/{type} | ANIME或MANGA的口味特征(流派权重、主题、评分模式) |
anilist://list/{type} | 当前正在观看/阅读带有进度和分数的条目 |
提示
客户可以提供的预先构建的对话启动器,作为快速行动。
| 提示 | 描述 |
|---|---|
setup | 逐步连接您的AniList帐户 |
seasonal_review | 根据你的口味来评论本季的动漫 |
what_to_watch | 用可选的心情和时间预算计划现在要看什么 |
roast_my_taste | 让你的动漫品味变得幽默 |
compare_us | 将您的口味与其他用户进行比较 |
year_in_review | 你的动漫/漫画年回顾 |
explain_title | 你为什么喜欢(或不喜欢)一个特定的标题? |
find_similar | 查找与您喜欢的标题相似的标题 |
例子
一旦连接了ani-mcp,你可以问你的人工智能助手一些事情:
“接下来我该看什么?” 用途 anilist_pick 分析你完成的列表,建立一个品味档案,并根据它们与你的偏好的匹配程度从你的计划列表中推荐标题。
“我想要一些黑暗和心理的东西” 用途 anilist_pick 通过情绪过滤来增强与这种氛围相匹配的标题,并惩罚不匹配的标题。
“这个季节有什么好的?” 用途 anilist_pick 随着 source: SEASONAL 根据你的喜好对当前播放的动漫进行排名。
“我有90分钟,今晚我该看什么?” 用途 anilist_session 从您当前的观看列表中选择,并用最匹配的剧集来填充时间预算。
“我完成的东西有续集吗?” 用途 anilist_sequels 将你完成的名单与本赛季的阵容进行对照。
“我看《命运》的顺序是什么?” 用途 anilist_watch_order 遍历特许经营关系图并生成编号的查看顺序。
“将我的品味与用户名进行比较123” 用途 anilist_compare 要查找共享标题,请计算兼容性得分,并突出显示最大的分歧。
“我为什么喜欢Vinland Saga?” 用途 anilist_explain 根据你的品味特征给标题打分,分解流派亲和力和主题一致性。
“让我看看我的动漫年回顾” 用途 anilist_wrapped 总结你在特定年份观看的所有内容。
情绪配置
anilist_pick 和 anilist_session 接受自由形式 mood 弦。内置关键字包括:黑暗、寒冷、炒作、动作、浪漫、有趣、聪明、悲伤、可怕、史诗、健康、激烈、神秘、幻想、科幻、迷幻、怀旧、艺术、竞争、舒适。
要添加或覆盖关键字,请设置 ANILIST_MOOD_CONFIG 作为JSON对象:
{
"ANILIST_MOOD_CONFIG": "{\"cozy\":{\"boost\":[\"Slice of Life\",\"Iyashikei\"],\"penalize\":[\"Horror\"]},\"mykeyword\":{\"boost\":[\"Romance\"],\"penalize\":[]}}"
}每个键都是一个情绪关键字映射到 { boost: string[], penalize: string[] } AniList流派和标签的数组。
隐私
看 隐私.md 了解详情。简而言之:ani-mcp在本地运行,只向AniList API发送请求,不存储任何内容,也不收集任何分析。
码头工人
docker build -t ani-mcp .
docker run -e ANILIST_USERNAME=your_username ani-mcp默认情况下,在端口3000上使用HTTP流传输运行。
从源代码构建
git clone https://github.com/gavxm/ani-mcp.git
cd ani-mcp
npm install
npm run build
npm test支持
Bug报告和功能请求:
