AniList MCP 服务器

与 AniList API 交互的模型上下文协议 (MCP) 服务器，允许 LLM 客户端访问并与 AniList 中的动漫、漫画、角色、员工和用户数据进行交互。

特征

• 搜索动画、漫画、角色、工作人员和工作室
• 获取有关特定动漫、漫画、角色和工作人员的详细信息
• 访问用户个人资料和列表
• 支持高级过滤选项
• 检索类型和媒体标签

先决条件

• Node.js 18+

与 Claude Desktop（或其他 MCP 客户端）一起使用

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 AniList MCP 服务器：

通过 mcp-get 安装

手动安装

1. 将此服务器添加到您的claude_desktop_config.json ：

如果您不打算使用 AniList Token 进行需要登录的操作，则可以完全删除env对象。

2. 重启Claude桌面
3. 使用工具与 AniList 进行交互

环境变量

• ANILIST_TOKEN ：（可选）AniList API 令牌（仅适用于需要登录的操作）

获取 AniList API 令牌（可选）

要获取 API 令牌，请按照以下步骤操作：

1. 转到AniList 设置。
2. 点击“创建新客户”。
3. 使用此 URL 作为客户端的“重定向 URL”：

4. 点击“保存”
5. 然后访问https://anilist.co/api/v2/oauth/authorize?client\_id={clientID}\&response\_type=token ，将{clientID}替换为您获取的客户端 ID。它会要求您登录，然后提供您要使用的令牌。
6. 复制生成的令牌并在您的.env文件或环境变量中使用它。

可用工具

杂项工具

• get_genres ：获取 AniList 上所有可用的类型
• get_media_tags ：获取 AniList 上所有可用的媒体标签
• get_site_statistics ：获取过去七天的 AniList 网站统计信息
• get_studio ：通过 AniList ID 或名称获取工作室的信息
• favourite_studio ：[需要登录] 通过 ID 收藏或取消收藏工作室

活动工具

• delete_activity ：[需要登录] 删除当前授权用户的活动帖子
• get_activity ：通过 ID 获取特定的 AniList 活动
• get_user_activity ：从用户获取活动
• post_message_activity ：[需要登录]发布新消息活动或更新现有消息活动
• post_text_activity ：[需要登录] 发布新的文本活动或更新现有的文本活动

列表工具

• get_user_anime_list ：获取用户的动漫列表
• get_user_manga_list ：获取用户的漫画列表
• add_list_entry ：[需要登录] 将条目添加到授权用户列表中
• remove_list_entry ：[需要登录]从授权用户列表中删除条目
• update_list_entry ：[需要登录] 更新授权用户列表中的条目

媒体工具

• get_anime ：通过 AniList ID 获取动漫的详细信息
• get_manga ：通过 AniList ID 获取漫画的详细信息
• favourite_anime ：[需要登录] 通过动漫 ID 收藏或取消收藏
• favourite_manga ：[需要登录] 通过漫画 ID 收藏或取消收藏

人员工具

• get_character ：通过 AniList ID 获取角色信息
• get_staff ：通过 AniList ID 获取员工信息
• favourite_character ：[需要登录] 通过 ID 收藏或取消收藏角色
• favourite_staff ：[需要登录] 通过 ID 收藏或取消收藏员工
• get_todays_birthday_characters ：获取今天过生日的所有角色
• get_todays_birthday_staff ：获取今天过生日的所有员工

推荐工具

• get_recommendation ：通过 ID 获取 AniList 推荐
• get_recommendations_for_media ：获取特定媒体的 AniList 推荐

搜索工具

• search_activity ：在 AniList 上搜索活动
• search_anime ：使用查询词和过滤器搜索动漫
• search_manga ：使用查询词和过滤器搜索漫画
• search_character ：根据查询词搜索字符
• search_staff ：根据查询词搜索工作人员
• search_studio ：根据查询词搜索工作室
• search_user ：在 AniList 上搜索用户

螺纹工具

• get_thread ：通过 AniList ID 获取特定线程
• get_thread_comments ：获取特定线程的评论
• delete_thread ：[需要登录] 通过 ID 删除线程

用户工具

• get_user_profile ：获取用户的 AniList 个人资料
• get_user_stats ：获取用户的 AniList 统计信息
• get_full_user_info ：获取用户的完整个人资料和统计信息
• get_user_recent_activity ：获取用户最近的活动
• get_authorized_user ：[需要登录] 获取当前授权用户的个人资料信息
• follow_user ：[需要登录] 通过用户 ID 关注或取消关注用户
• update_user ：[需要登录] 更新用户设置

示例用法

基本动漫搜索

获取角色信息

比较 Studio Works

本地开发

该项目使用Bun作为包管理器。如果您还没有安装，请先安装。

克隆存储库并安装依赖项：

配置（可选）

1. 通过复制示例创建.env文件：

2. 编辑.env文件并添加您的 AniList API 令牌：

使用 MCP Inspector 进行调试

您可以使用 MCP Inspector 来测试和调试 AniList MCP 服务器：

然后打开浏览器，访问提供的 URL（通常是http://127.0.0.1:6274 ）以访问 MCP 检查器界面。从那里，您可以：

1. 连接到您正在运行的 AniList MCP 服务器
2. 浏览可用的工具
3. 使用自定义参数运行工具
4. 查看回复

这对于在将您的设置连接到 Claude 或其他 AI 助手之前进行测试特别有用。

Docker

从 Docker Hub 拉取：

Docker 构建（本地开发）：

Docker多平台构建（本地开发）：

安全声明

此 MCP 服务器接受您的 AniList API 令牌，令牌存储在 .env 文件中或作为环境变量。请妥善保管此信息，切勿将其提交到版本控制中。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。