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 許可證。