AniList MCP Server

AniList MCP服务器

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

特性

• 搜索动漫、漫画、人物、工作人员和工作室
• 获取有关特定动漫、漫画、角色和工作人员的详细信息
• 访问用户配置文件和列表
• 支持高级过滤选项
• 检索流派和媒体标签
• 双重运输支持：HTTP和STDIO传输
• 云部署就绪：支持Smithery和其他平台

需求

• Node.js 18+

本地安装（STDIO传输）

1. 将此服务器添加到您的 mcp.json / claude_desktop_config.json:

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

您可以删除 env 如果您不打算将AniList令牌用于需要登录的操作，请完全使用该对象。

1. 重新启动MCP客户端（例如，Claude Desktop）
2. 使用工具与AniList交互

服务器部署（HTTP传输）

自我寄宿

跟随 地方发展 在本地设置项目的说明，然后运行：

pnpm run start:http

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

云部署

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

您还可以通过MCP平台进行部署，例如 铁匠铺.

配置

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

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

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

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

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

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

• Anilist-Token：（可选）AniList API令牌（仅用于需要登录的操作）

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

获取AniList API令牌（可选）

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

1. 首选 AniList设置.
2. 点击“创建新客户端”。
3. 将此URL用作客户端的“重定向URL”：

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

1. 点击“保存”
2. 然后转到https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=令牌，替换 {clientID} 使用您获得的客户端ID。它会要求您登录，然后为您提供要使用的令牌。
3. 复制生成的令牌并在您的 .env 文件或环境变量。

可用工具

其他工具

• get_genres：获取AniList上所有可用的流派
• get_media_tags：获取AniList上的所有可用媒体标签
• get_site_statistics：获取AniList网站过去七天的统计数据
• get_studio：通过AniList ID或名称获取工作室的信息
• 喜爱的工作室：\[需要登录\]按工作室ID收藏或取消收藏工作室

活动工具

• 删除活动：\[需要登录\]删除当前授权用户的活动帖子
• get_activity：通过ID获取特定的AniList活动
• 获取用户活动：从用户获取活动
• post_message活动：\[需要登录\]发布新的消息活动或更新现有的消息活动
• 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获取漫画的详细信息
• 偏袒：\[需要登录\]通过ID收藏或取消收藏动漫
• favourite_manga：\[需要登录\]通过漫画ID收藏或取消收藏漫画

人员工具

• get_character：通过角色的AniList ID获取角色信息
• 获取_关闭：通过AniList ID获取员工信息
• 偏爱_特征：\[需要登录\]通过ID收藏或取消收藏角色
• favorite_staff：\[需要登录\]根据员工的ID对其进行收藏或取消收藏
• get_todays_birthday_字符：获取生日在今天的所有角色
• get_todays_birthday_staff：让所有生日在今天的员工参加

推荐工具

• 获取_推荐：通过ID获取AniList推荐
• 获取媒体推荐：获取特定媒体的AniList推荐

搜索工具

• 搜索活动：在AniList上搜索活动
• 搜索_尼姆：使用查询词和过滤器搜索动漫
• search_manga：使用查询词和过滤器搜索漫画
• 搜索字符：根据查询词搜索字符
• 搜索_关闭：根据查询词搜索工作人员
• 搜索_音频：根据查询词搜索工作室
• 搜索用户：在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_活动：获取用户最近的活动
• 获取授权用户：\[需要登录\]获取当前授权用户的个人资料信息
• follow_user：\[需要登录\]根据用户的ID关注或取消关注用户
• update_user：\[需要登录\]更新用户设置

示例用法

基本动漫搜索

Can you search for anime similar to "Bocchi the Rock!"?

获取角色信息

Can you tell me about the character Hitori Gotou? Use the AniList tools to find information.

比较工作室作品

What anime has Studio Ghibli produced? Can you list their most popular works?

地方发展

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

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

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

配置（可选）

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

cp env.example .env

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

ANILIST_TOKEN=your_api_token

使用MCP检查器进行调试

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

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

# Use this instead when Local Development
pnpm run inspector

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

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

这对于在将安装程序连接到Claude Desktop等MCP客户端之前对其进行测试特别有用。

码头工人

从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许可证获得许可-请参阅 许可证 文件以获取详细信息。