AniList MCP 服务器

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

功能

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

先决条件

Node.js 18+

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

通过 Smithery 安装

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

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 <client_name>

通过 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": "your_api_token"
      }
    }
  }
}

如果您不打算使用 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: [需要登录] 通过 ID 收藏或取消收藏漫画

人物工具

get_character: 通过 AniList ID 获取角色的信息
get_staff: 通过 AniList ID 获取工作人员的信息
favourite_character: [需要登录] 通过 ID 收藏或取消收藏角色
favourite_staff: [需要登录] 通过 ID 收藏或取消收藏工作人员
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: [需要登录] 更新用户设置

示例用法

基本动漫搜索

你能搜索类似于《孤独摇滚！》的动漫吗？

获取角色信息

你能告诉我关于后藤一里的信息吗？使用 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=your_api_token

使用 MCP Inspector 调试

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

npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=your_api_token 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 文件。