anilist

🚀 AniList MCP 服务器

这是一个适用于 AniList 的模型上下文协议（MCP）服务器，它提供了丰富的功能，能帮助用户在 AniList 上进行搜索、获取信息、获取推荐、进行互动等操作。

🚀 快速开始

你可以通过以下几种方式来安装和运行 AniList MCP 服务器：

• 使用 npm 快速安装：

npm install -g anilist-mcp
anilist-mcp

• 本地开发（推荐使用 Bun）：
  1. 克隆仓库：

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

  2. 安装依赖：

  bun install
  

  3. 启动服务器：

  bun run dev
  

✨ 主要特性

• 搜索工具：支持通过查询词和筛选条件搜索 anime、manga、角色、工作人员、工作室及用户。
• 信息获取工具：提供检索特定媒体、角色、人员、工作室及用户详细信息的功能。
• 推荐工具：能够获取指定媒体的 AniList 推荐。
• 互动工具：支持收藏、关注及其他互动操作，如点赞和评论管理。
• 实用工具：包括用户资料查看、统计信息获取、生日提醒等功能。

📦 安装指南

配置（可选）

1. 创建 .env 文件，基于示例配置：

cp .env.example .env

2. 根据需要编辑 .env 文件，添加 AniList API 令牌：

ANILIST_TOKEN=your_api_token_here

使用 Docker

• 拉取镜像：

docker pull yuna0x0/anilist-mcp

• 本地构建：

docker build -t yuna0x0/anilist-mcp .

• 多平台构建：

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

💻 使用示例

基本用法

基本 Anime 搜索

你能搜索与《Bocchi the Rock!》相似的动漫吗？

获取特定 Manga 信息

# 获取 manga 的详细信息
mcp-get-manga-info -i <id> --api-key <your_api_key>

# 示例：
mcp-get-manga-info -i 1023456 --api-key abcdefghijklmnopqrstuvwxyz

🔧 调试与检查

使用 MCP 检查器

1. 启动服务：

mcp-service start

2. 打开浏览器访问 http://localhost:3000，输入以下命令进行测试：

• 获取帮助信息：

help

• 搜索 anime：

search-anime --query "Bocchi the Rock!"

⚠️ 重要提示

⚠️ 重要提示

• 保护 API 令牌：避免在版本控制系统中暴露 API 密钥。
• 环境变量管理：建议将敏感信息存储于 .env 文件并加入 .gitignore，以防意外泄露。

📄 许可证

本项目遵循 MIT 许可证。