SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台anilist-mcp

anilist-mcp

AniList MCP 服务器是一个基于 Model Context Protocol（MCP）的服务器，用于对接 AniList API，让 LLM 客户端能够访问和交互 AniList 上的动漫、漫画、角色、制作人员及用户数据。它支持搜索动漫、漫画、角色、制作人员和工作室，获取特定条目的详细信息，访问用户资料和列表，并支持高级筛选选项。该服务器同时支持 HTTP 和 STDIO 两种传输方式，可本地安装或部署到云端（如 Smithery 等平台）。部分操作（如收藏、发帖、更新列表等）需要登录并配置 AniList API Token。

访问官网

工具介绍

用途

AniList MCP 服务器是一个 Model Context Protocol（MCP）服务器，用于对接 AniList API，使 LLM 客户端能够访问和交互 AniList 上的动漫、漫画、角色、制作人员及用户数据。

主要能力

  • 搜索动漫、漫画、角色、制作人员和工作室
  • 获取特定动漫、漫画、角色和制作人员的详细信息
  • 访问用户资料和列表
  • 支持高级筛选选项
  • 获取类型（genres）和媒体标签（media tags）
  • 双传输支持：同时支持 HTTP 和 STDIO 传输
  • 支持云端部署：兼容 Smithery 及其他平台

使用方式

本地安装（STDIO 传输）

将此服务器添加到你的 mcp.json / claude_desktop_config.json 中。如果不打算使用需要登录的 AniList Token 操作，可以完全移除 env 对象。重启 MCP 客户端（如 Claude Desktop），然后使用工具与 AniList 交互。

服务器部署（HTTP 传输）

按照本地开发说明在本地设置项目，然后运行。默认会在 8081 端口启动服务器，可通过设置 PORT 环境变量更改端口。

云端部署

可将此 MCP 服务器部署到任何支持 Node.js 服务器应用的云平台，也可通过 Smithery 等 MCP 平台部署。

环境变量（STDIO 传输及由主机提供配置的 HTTP 传输服务器）

使用 STDIO 传输或托管 HTTP 传输服务器时，可通过环境变量传递配置：

  • ANILIST_TOKEN：（可选）AniList API Token（仅登录相关操作需要）

如果托管 HTTP 传输服务器并预配置了 token，应保护端点并实现身份验证后再允许用户访问，否则任何人都能在使用你的 AniList token 的情况下访问你的 MCP 服务器。

HTTP 头（由用户提供配置的 HTTP 传输）

使用 HTTP 传输时，用户可通过 HTTP 头传递配置：

  • Anilist-Token：（可选）AniList API Token（仅登录相关操作需要）

如果用户在头中提供 token，而服务器也设置了 ANILIST_TOKEN，则头中的值优先。

获取 AniList API Token（可选）

  1. 前往 AniList 设置。
  2. 点击 "Create New Client"。
  3. 将此 URL 用作客户端的 "Redirect URL"。
  4. 然后访问 https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token ，将 {clientID} 替换为你获得的客户端 ID。它会要求你登录，然后提供 token。
  5. 复制生成的 token，用于 .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：[需要登录] 更新用户设置

本地开发

本项目使用 pnpm 作为包管理器。克隆仓库并安装依赖。

配置（可选）

复制示例创建 .env 文件，编辑 .env 文件并添加你的 AniList API token。

使用 MCP Inspector 调试

可使用 MCP Inspector 测试和调试 AniList MCP 服务器。然后打开浏览器访问提供的 URL（通常为 http://localhost:6274 ）以访问 MCP Inspector 界面。在那里你可以：

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

这在将设置连接到 Claude Desktop 等 MCP 客户端之前测试配置时特别有用。

Docker

从 GitHub Container Registry 拉取。Docker 构建（本地开发）。Docker 多平台构建（本地开发）。

MCP Bundles（MCPB）

要为此服务器创建 MCP Bundle，请运行相应命令。

安全提示

此 MCP 服务器接受 .env 文件、环境变量或 HTTP 头中的 AniList API token。请确保信息安全，切勿提交到版本控制。

本项目采用 MIT 许可证。

同类工具

查看分类