AniList MCP 服务器

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

功能

搜索动漫、漫画、角色、工作人员和工作室
获取特定动漫、漫画、角色和工作人员的详细信息
访问用户个人资料和列表
支持高级过滤选项
获取类型和媒体标签
双传输支持：HTTP 和 STDIO 传输
云部署就绪：支持 Smithery 和其他平台

要求

Node.js 18+

本地安装（STDIO 传输）

将此服务器添加到您的 mcp.json / claude_desktop_config.json 中：

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

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

重启您的 MCP 客户端（例如，Claude Desktop）
使用工具与 AniList 交互

服务器部署（HTTP 传输）

自托管

按照本地开发说明在本地设置项目，然后运行：

pnpm run start:http

默认情况下，服务器将在端口 8081 上启动。您可以通过设置 PORT 环境变量来更改端口。

云部署

您可以将此 MCP 服务器部署到任何支持 Node.js 服务器应用程序的云平台。

您也可以通过 MCP 平台如 Smithery 进行部署。

配置

环境变量（STDIO 传输和 HTTP 传输服务器，其中主机提供配置）

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

ANILIST_TOKEN: （可选）AniList API 令牌（仅需要登录操作）

[!CAUTION] 如果您在托管 HTTP 传输服务器时预先配置了令牌，您应该保护您的端点并在允许用户访问之前实施身份验证。否则，任何人都可以在使用您的 AniList 令牌时访问您的 MCP 服务器。

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

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

Anilist-Token: （可选）AniList API 令牌（仅需要登录操作）

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

获取 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 工具查找信息。

比较工作室作品

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

本地开发

该项目使用 pnpm 作为其包管理器。

克隆仓库并安装依赖项：

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

配置（可选）

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

cp env.example .env

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

ANILIST_TOKEN=your_api_token

使用 MCP 检查器调试

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

npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=your_api_token npx anilist-mcp

# 在本地开发时使用此命令
pnpm run inspector

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

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

这对于在将其连接到 MCP 客户端（如 Claude Desktop）之前测试您的设置特别有用。

Docker

从 GitHub 容器注册表拉取：

docker pull ghcr.io/yuna0x0/anilist-mcp

Docker 构建（本地开发）：

docker build -t ghcr.io/yuna0x0/anilist-mcp .

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

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

MCP 包（MCPB）

要为此服务器创建 MCP 包，请运行：

pnpm run pack:mcpb

安全通知

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

许可证

该项目根据 MIT 许可证授权 - 请参阅 LICENSE 文件以获取详细信息。