anilist-mcp

by yuna0x0
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for accessing and interacting with anime, manga, character, staff, and user data from AniList, including search capabilities, detailed information retrieval, user profiles and lists, filtering options, and genre/media tag data.

AniList MCP サーバー

AniList API とインターフェイスするモデル コンテキスト プロトコル (MCP) サーバー。LLM クライアントが AniList からアニメ、マンガ、キャラクター、スタッフ、およびユーザー データにアクセスして対話できるようにします。

特徴

  • アニメ、マンガ、キャラクター、スタッフ、スタジオを検索
  • 特定のアニメ、マンガ、キャラクター、スタッフに関する詳細情報を入手
  • ユーザープロフィールとリストにアクセスする
  • 高度なフィルタリングオプションのサポート
  • ジャンルとメディアタグを取得する

前提条件

  • Node.js 18歳以上

Claude Desktop(または他のMCPクライアント)と併用する

Smithery経由でインストール

Smithery経由で Claude Desktop 用の AniList MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @yuna0x0/anilist-mcp --client claude # For other MCP clients, use the following command: # List available clients npx -y @smithery/cli list clients # Install to other clients npx -y @smithery/cli install @yuna0x0/anilist-mcp --client <client_name>

mcp-get 経由でインストールする

npx @michaellatman/mcp-get@latest install anilist-mcp

手動インストール

  1. このサーバーをclaude_desktop_config.jsonに追加します。
{ "mcpServers": { "anilist": { "command": "npx", "args": ["-y", "anilist-mcp"], "env": { "ANILIST_TOKEN": "your_api_token" } } } }

ログインを必要とする操作に AniList トークンを使用する予定がない場合は、 envオブジェクトを完全に削除できます。

  1. Claudeデスクトップを再起動します
  2. AniListと対話するためのツールを使用する

環境変数

  • ANILIST_TOKEN : (オプション) AniList API トークン (ログインが必要な操作にのみ必要)

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=token にアクセスし、 {clientID}を取得したクライアントIDに置き換えてください。ログインを求められ、使用するトークンが提供されます。
  3. 生成されたトークンをコピーし、 .envファイルまたは環境変数で使用します。

利用可能なツール

その他のツール

  • get_genres : AniList で利用可能なすべてのジャンルを取得します
  • get_media_tags : AniList で利用可能なすべてのメディアタグを取得します
  • get_site_statistics : 過去7日間のAniListサイト統計を取得します
  • get_studio : AniList IDまたは名前でスタジオの情報を取得します
  • favourite_studio : [ログインが必要] スタジオをIDでお気に入りに追加またはお気に入り解除する

アクティビティツール

  • delete_activity : [ログインが必要] 現在承認されているユーザーのアクティビティ投稿を削除します
  • get_activity : IDで特定のAniListアクティビティを取得します
  • get_user_activity : ユーザーからアクティビティを取得する
  • post_message_activity : [ログインが必要] 新しいメッセージアクティビティを投稿するか、既存のメッセージアクティビティを更新します
  • 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でマンガの詳細情報を取得します
  • favourite_anime : [ログインが必要] IDでアニメをお気に入りに追加またはお気に入り解除する
  • favourite_manga : [ログインが必要] IDでマンガをお気に入りに追加またはお気に入り解除する

人材ツール

  • get_character : AniList IDでキャラクターの情報を取得します
  • get_staff : AniList IDでスタッフメンバーの情報を取得します
  • favourite_character : [ログインが必要] IDでキャラクターをお気に入りに登録または解除する
  • favourite_staff : [ログインが必要] スタッフのIDでお気に入りに追加またはお気に入り解除
  • get_todays_birthday_characters : 今日が誕生日のキャラクターをすべて取得する
  • get_todays_birthday_staff : 今日が誕生日のスタッフ全員を取得します

推奨ツール

  • get_recommendation : IDでAniListの推奨事項を取得する
  • get_recommendations_for_media : 特定のメディアの AniList の推奨事項を取得します

検索ツール

  • search_activity : AniList でのアクティビティを検索
  • search_anime : 検索語とフィルターでアニメを検索
  • search_manga : 検索語とフィルターを使ってマンガを検索
  • search_character : 検索語に基づいて文字を検索します
  • search_staff : 検索語に基づいてスタッフを検索します
  • search_studio : 検索語に基づいてスタジオを検索します
  • search_user : 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_activity : ユーザーの最近のアクティビティを取得する
  • get_authorized_user : [ログインが必要] 現在承認されているユーザーのプロフィール情報を取得します
  • 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?

地域開発

このプロジェクトではパッケージマネージャーとしてBunを使用しています。まだインストールしていない場合はインストールしてください。

リポジトリをクローンし、依存関係をインストールします。

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

構成(オプション)

  1. 次の例をコピーして.envファイルを作成します。
cp .env.example .env
  1. .envファイルを編集し、AniList API トークンを追加します。
ANILIST_TOKEN=your_api_token

MCP Inspectorによるデバッグ

MCP インスペクターを使用して、AniList MCP サーバーをテストおよびデバッグできます。

npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=your_api_token npx anilist-mcp # Use this instead when Local Development bun run inspector

次に、ブラウザで指定されたURL(通常はhttp://127.0.0.1:6274 )を開き、MCP Inspectorインターフェースにアクセスします。そこから以下の操作が可能です。

  1. 実行中のAniList MCPサーバーに接続します
  2. 利用可能なツールを参照する
  3. カスタムパラメータでツールを実行する
  4. 回答を見る

これは、Claude または他の AI アシスタントに接続する前にセットアップをテストする場合に特に便利です。

ドッカー

Docker Hub からプル:

docker pull yuna0x0/anilist-mcp

Docker ビルド (ローカル開発):

docker build -t yuna0x0/anilist-mcp .

Docker マルチプラットフォーム ビルド (ローカル開発):

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

セキュリティに関するお知らせ

このMCPサーバーは、AniList APIトークンを.envファイルまたは環境変数として受け取ります。この情報は安全に保管し、バージョン管理にコミットしないでください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

ID: 3w7jxbmhi7