AniList MCP 服务器

一个模型上下文协议 (MCP) 服务器，它与 AniList API 接口，允许 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

手动安装

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

{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "anilist-mcp"],
      "env": {
        "ANILIST_TOKEN": "your_api_token"
      }
    }
  }
}

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

2. 重启 Claude Desktop
3. 使用这些工具与 AniList 交互

环境变量

• ANILIST_TOKEN: (可选) AniList API Token (仅用于需要登录的操作)

获取 AniList API Token (可选)

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

1. 转到 AniList 设置。
2. 点击 "Create New Client"。
3. 使用此 URL 作为您的客户端的 "Redirect URL":

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

4. 点击 "Save"
5. 然后转到 https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token，将 {clientID} 替换为您获得的客户端 ID。它会要求您登录，然后为您提供要使用的 token。
6. 复制生成的 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: [需要登录] 更新用户设置

使用示例

基本动漫搜索

你能搜索一下类似于 "孤独摇滚！" 的动漫吗？

获取角色信息

你能告诉我关于角色后藤一里的信息吗？使用 AniList 工具查找信息。

比较工作室作品

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

本地开发

此项目使用 Bun 作为其包管理器。如果您尚未安装，则应安装它。

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

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

配置 (可选)

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

cp .env.example .env

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

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://localhost:5173）以访问 MCP Inspector 界面。从那里，您可以：

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

这对于在将其连接到 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 服务器接受您的 AniList API token 在 .env 文件中或作为环境变量。请确保此信息的安全，并且永远不要将其提交到版本控制。

许可证

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