AniList MCP 服务器

一个与 AniList API 交互的模型上下文协议（MCP）服务器，允许大型语言模型（LLM）客户端访问和交互 AniList 中的动画、漫画、角色、工作人员和用户数据。

功能

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

前置条件

Node.js 18+

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

通过 Smithery 安装

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

npx -y @smithery/cli install @yuna0x0/anilist-mcp --client claude

# 对于其他MCP客户端，使用以下命令：
# 列出可用客户端
npx -y @smithery/cli list clients
# 安装到其他客户端
npx -y @smithery/cli install @yuna0x0/anilist-mcp --client <客户端名称>

通过 mcp-get 安装

npx @michaellatman/mcp-get@latest install anilist-mcp

手动安装

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

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

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

重启 Claude Desktop
使用工具与 AniList 交互

环境变量

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

获取 AniList API 令牌（可选）

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

前往 AniList 设置。
点击 "创建新客户端"。
将此 URL 作为你客户端的 "重定向 URL"：

https://anilist.co/api/v2/oauth/pin

点击 "保存"
然后前往 https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token，将 {clientID} 替换为你获得的客户端 ID。它会要求你登录，然后提供你使用的令牌。
复制生成的令牌，并在你的 .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：[需要登录] 收藏或取消收藏漫画

人物工具

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

搜索工具

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：[需要登录] 更新用户设置

示例用法

基本动画搜索

你能搜索与 "Bocchi the Rock!" 类似的动画吗？

获取角色信息

你能告诉我关于角色 Hitori Gotou 的信息吗？使用 AniList 工具来查找信息。

比较工作室作品

吉卜力工作室制作了哪些动画？你能列出他们最受欢迎的作品吗？

本地开发

此项目使用 Bun 作为其包管理器。如果你还没有安装，应该安装它。

克隆仓库并安装依赖项：

git clone https://github.com/yuna0x0/anilist-mcp.git
cd anilist-mcp
bun install

配置（可选）

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

cp .env.example .env

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

ANILIST_TOKEN=你的API令牌

使用 MCP Inspector 进行调试

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

npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=你的API令牌 npx anilist-mcp

# 在本地开发时使用以下命令
bun run inspector

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

连接到正在运行的 AniList MCP 服务器
浏览可用工具
使用自定义参数运行工具
查看响应

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

Docker

从 Docker Hub 拉取：

docker pull yuna0x0/anilist-mcp

本地开发 Docker 构建：

docker build -t yuna0x0/anilist-mcp .

本地开发多平台 Docker 构建：

docker buildx build --platform linux/amd64,linux/arm64 -t yuna0x0/anilist-mcp .

安全提示

此 MCP 服务器在 .env 文件或作为环境变量接受你的 AniList API 令牌。请确保信息安全，切勿将其提交到版本控制。

许可证

本项目根据 MIT 许可证授权 - 详细内容请参阅 LICENSE 文件。

yuna0x0/anilist-mcp

星标增长

证据时间轴