Anilist

🚀 AniList MCP サーバー

AniList 用のモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、AniList 上の様々な情報を検索、取得、推薦し、ユーザーとのインタラクションをサポートする機能を提供します。

🚀 クイックスタート

このサーバーをすぐに使い始めることができます。以下のセクションでは、インストール方法、設定方法、使用例などを説明します。

✨ 主な機能

• 🔍 検索ツール：クエリやフィルタ条件を使って、anime、manga、キャラクター、スタッフ、スタジオ、ユーザーを検索できます。
• 📄 情報取得ツール：特定のメディア、キャラクター、人物、スタジオ、ユーザーの詳細情報を取得できます。
• 🌟 推薦ツール：指定したメディアの AniList 推薦を取得できます。
• 🤝 インタラクションツール：お気に入り登録、フォロー、いいねやコメント管理などのインタラクション操作をサポートします。
• 🛠️ ユーティリティツール：ユーザープロファイルの閲覧、統計情報の取得、誕生日通知などの機能があります。

📦 インストール

クイックインストール（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
   

設定（オプション）

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 ライセンスの下で提供されています。