项目简介

AniList MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它充当 LLM 客户端和 AniList API 之间的桥梁。通过这个服务器，LLM 可以以标准化的方式访问和操作 AniList 上的动漫、漫画、角色、工作人员和用户数据，从而扩展 LLM 在动漫和漫画领域的知识和能力。

主要功能点

数据检索: 提供多种工具，用于搜索和获取动漫、漫画、角色、工作人员、工作室等详细信息。
用户列表管理: 支持访问和管理用户的动漫和漫画列表，包括添加、更新和删除条目。
用户活动: 可以获取用户活动信息，并允许用户发布和删除活动（需要登录）。
收藏管理: 允许用户收藏和取消收藏动漫、漫画、角色、工作人员和工作室（需要登录）。
辅助功能: 提供获取动漫类型、媒体标签、站点统计数据等辅助工具。
灵活搜索: 支持关键词搜索和高级过滤选项，精确查找所需内容。

安装步骤

克隆仓库

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

安装依赖

使用 bun, npm, yarn 或 pnpm 安装项目依赖：

bun install

或者

npm install

或者

yarn install

或者

pnpm install

配置 AniList API Token (可选)

对于需要用户授权的操作（例如收藏、更新列表等），你需要提供 AniList API Token。你可以通过以下两种方式配置：
- 方式一：使用 .env 文件 复制 '.env.example' 文件并重命名为 '.env'，然后编辑 '.env' 文件，填入你的 AniList API Token。
```
cp .env.example .env
```
  编辑 '.env' 文件:
```
ANILIST_TOKEN=your_api_token
```
- 方式二：使用环境变量 在启动服务器时，直接通过环境变量传入 API Token。

服务器配置

要将 AniList MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要在客户端的配置文件中添加服务器信息。以下是一个 'claude_desktop_config.json' 的配置示例，展示了如何配置 AniList MCP Server：

{
  "mcpServers": {
    "anilist": {
      "command": "bun",
      "args": ["start"],
      "env": {
        "ANILIST_TOKEN": "your_api_token"
      }
    }
  }
}

配置参数说明:

'"anilist"': 服务器名称，可以自定义，用于在客户端中标识和引用该服务器。
'"command": "bun"': 启动服务器的命令。这里假设你使用 bun 运行服务器，如果使用 npm，则应为 '"npm"'。
'"args": ["start"]': 传递给启动命令的参数。'"start"' 是 'package.json' 中定义的启动脚本。
'"env": { "ANILIST_TOKEN": "your_api_token" }': 环境变量配置。'ANILIST_TOKEN' 用于传递 AniList API Token，'your_api_token' 需要替换为你自己的 Token。如果你选择使用 '.env' 文件配置 Token，则可以移除 'env' 部分。

基本使用方法

启动 MCP 服务器

在项目根目录下，使用以下命令启动服务器：
```
bun start
```
或者使用 npm, yarn, pnpm 启动：
```
npm start
```
```
yarn start
```
```
pnpm start
```
使用 MCP Inspector 测试 (可选)

你可以使用 MCP Inspector 来测试服务器的功能。运行以下命令启动 Inspector：
```
bun run inspector
```
或者使用 npm, yarn, pnpm 启动：
```
npm run inspector
```
```
yarn run inspector
```
```
pnpm run inspector
```
然后打开浏览器访问 Inspector 提供的 URL（通常是 'http://localhost:5173'），在 Inspector 界面中连接到你的 AniList MCP Server 进行工具测试和调试。
在 MCP 客户端中使用

配置好 MCP 客户端（如 Claude Desktop）后，客户端将自动连接到 AniList MCP Server。你可以在客户端中通过自然语言指令调用服务器提供的工具，例如：
- "搜索关于 '进击的巨人' 的动漫"
- "获取角色 '五条悟' 的信息"
- "查看用户 'example_user' 的动漫列表"
LLM 客户端会解析你的指令，并调用 AniList MCP Server 提供的相应工具来获取数据，并将结果返回给你。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息