Ani Mcp

ani-mcp

あなたのアニメやマンガの好みを理解する、AniList 用のスマートな MCP サーバーです。生の API 呼び出しだけではありません。

このツールの特徴

AniList との連携の多くは、API をそのまま再現するものです。ani-mcp はその上にインテリジェンスレイヤーを追加します。

• 好みのプロファイリング - 完了済みリストから、あなたの好みのモデルを作成します
• パーソナライズされたおすすめ - 好みや気分、今期のラインナップをもとに「次は何を観るべき？」に答えます
• 相性チェック - 2 人のユーザーの好みを比較します
• 続編アラート - 視聴済みの作品の続編が今期放送されるかを確認できます
• 視聴順 - 長期シリーズのフランチャイズをたどって視聴順を確認できます
• 視聴計画 - 現在のリストから「90 分あるけれど、何を観よう？」を提案します
• 年間レビュー - 視聴・読書の統計をまとめます

さらに、検索、詳細情報、トレンド、シーズン別の閲覧、リスト管理、ソーシャル機能、コミュニティのおすすめといった基本機能も備えています。検索・閲覧ツールはすべてページネーションに対応しており、最初のページ以降の結果も閲覧できます。

30 秒で試す

アカウントは不要です。MCP 対応のクライアントであれば利用できます。

Claude Desktop

設定ファイル（Settings > Developer > Edit Config、または macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "ani-mcp"]
    }
  }
}

保存したあと、Claude Desktop を再起動してください。

または、最新リリースから ani-mcp.mcpb をダウンロードし、Settings > Extensions からインストールします。

Claude Code

claude mcp add ani-mcp -- npx -y ani-mcp

パーソナライズ機能

おすすめ、好みのプロファイリング、リスト管理を利用するには、ユーザー名を追加します。

{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "ani-mcp"],
      "env": {
        "ANILIST_USERNAME": "your_username"
      }
    }
  }
}

進捗の更新、スコアの登録、リストの編集などの書き込み操作には、ANILIST_TOKEN も追加してください。詳しくは環境変数をご覧ください。

環境変数

変数	必須	説明
ANILIST_USERNAME	いいえ	リスト・統計ツールで使用するデフォルトのユーザー名です。呼び出しごとに指定することもできます。
ANILIST_TOKEN	いいえ	AniList OAuth トークンです。書き込み操作と非公開リストに必要です。
ANILIST_TITLE_LANGUAGE	いいえ	タイトルの表示設定です。english（デフォルト）、romaji、または native を指定します。
ANILIST_SCORE_FORMAT	いいえ	スコアの表示形式を上書きします。POINT_100、POINT_10_DECIMAL、POINT_10、POINT_5、POINT_3 を指定できます。
ANILIST_NSFW	いいえ	成人向けコンテンツを結果に含めるには true に設定します。デフォルトは false です。
ANILIST_MOOD_CONFIG	いいえ	ムードのキーワードを追加・上書きする JSON オブジェクトです。ムード設定をご覧ください。
DEBUG	いいえ	stderr にデバッグログを出力するには true に設定します。
MCP_TRANSPORT	いいえ	HTTP Stream トランスポートを使用するには http に設定します。デフォルトは stdio です。
MCP_PORT	いいえ	HTTP トランスポートのポートです。デフォルトは 3000 です。
MCP_HOST	いいえ	HTTP トランスポートのホストです。デフォルトは localhost です。

ツール

検索と発見

ツール	説明
anilist_search	ジャンル、年、フォーマットのフィルターを指定して、タイトルからアニメ／マンガを検索します
anilist_details	タイトルの詳細、関連作品、おすすめを表示します
anilist_seasonal	シーズンごとのアニメのラインナップを閲覧します
anilist_trending	現在AniListで話題の作品を表示します
anilist_genres	オプションのフィルターを指定して、ジャンル別の人気作品を閲覧します
anilist_genre_list	有効なジャンルとコンテンツタグをすべて一覧表示します
anilist_recommendations	特定のタイトルに対するコミュニティのおすすめを表示します

リストと統計

ツール	説明
anilist_list	ステータスで絞り込んだユーザーのアニメ／マンガリストを表示します
anilist_lookup	特定のタイトルがユーザーのリストにあるか確認します
anilist_stats	視聴／読書統計、トップジャンル、スコア分布を表示します

インテリジェンス

ツール	説明
anilist_taste	完了済みリストから好みのプロフィールを生成します
anilist_pick	バックログ、シーズンのラインナップ、または発見候補から、次に見る作品をパーソナライズして提案します
anilist_compare	2人のユーザーの好みの相性を比較します
anilist_wrapped	1年間を振り返るサマリーを表示します
anilist_explain	「なぜこの作品が気に入るのか？」—好みのプロフィールに基づいて作品を評価します
anilist_similar	指定したアニメまたはマンガに似た作品を探します
anilist_sequels	完了済みのタイトルの続編で、今シーズンに放送される作品を表示します
anilist_watch_order	フランチャイズ作品の視聴順を表示します
anilist_session	時間の予算に合わせて視聴セッションを計画します
anilist_mal_import	MyAnimeListユーザーのリストをインポートし、おすすめを生成します
anilist_kitsu_import	Kitsuユーザーのリストをインポートし、おすすめを生成します

カード

ツール	説明
anilist_taste_card	共有可能な好みのプロフィールカードをPNG画像として生成します
anilist_compat_card	2人のユーザーを比較した相性カードをPNG画像として生成します

情報

ツール	説明
anilist_staff	タイトルのスタッフクレジットと声優を表示します
anilist_staff_search	名前から人物を検索し、参加作品をすべて表示します
anilist_studio_search	スタジオを検索し、制作作品を表示します
anilist_schedule	放送スケジュールと次回エピソードまでのカウントダウンを表示します
anilist_airing	現在視聴中のタイトルの今後のエピソードを表示します
anilist_characters	登場作品と声優を含め、名前からキャラクターを検索します
anilist_whoami	認証ステータスとスコア形式を確認します

ソーシャル

ツール	説明
anilist_profile	ユーザーのプロフィール、自己紹介、お気に入り、統計を表示します
anilist_feed	ユーザーのフィードから最近のアクティビティを表示します
anilist_reviews	タイトルに対するコミュニティのレビューを表示します
anilist_favourite	アニメ、マンガ、キャラクター、スタッフ、またはスタジオのお気に入り登録を切り替えます
anilist_activity	フィードにテキストアクティビティを投稿します
anilist_group_pick	グループで一緒に見るアニメ／マンガを探します
anilist_shared_planning	2人のユーザーの視聴予定リストの重複を探します
anilist_follow_suggestions	フォロー中のユーザーを好みの相性順に並べます
anilist_react	アクティビティに「いいね」または返信します

分析

ツール	説明
anilist_calibration	ジャンルごとのスコア付けの偏りをコミュニティの評価と比較します
anilist_drops	視聴・読書を中断する傾向を分析します。ジャンル／タグのクラスターと、中断する時点の中央値を表示します
anilist_evolution	2年間の期間ごとに、好みがどのように変化したかを表示します
anilist_completionist	関連作品のグラフを使って、フランチャイズ作品の完了状況を追跡します
anilist_seasonal_stats	シーズンごとの視聴・読書開始／完了／中断率を表示します
anilist_pace	現在視聴中のタイトルの完了予定日を推定します

書き込み（ANILIST_TOKEN が必要です）

ツール	説明
anilist_update_progress	エピソードまたはチャプターの進捗を更新します
anilist_add_to_list	ステータスを指定してタイトルをリストに追加します
anilist_rate	タイトルを採点します（0～10）
anilist_delete_from_list	リストからエントリーを削除します
anilist_undo	最後の書き込み操作を元に戻します
anilist_unscored	一括採点用に、完了済みで未採点のタイトルを一覧表示します
anilist_batch_update	リストのエントリーを一括で絞り込み、操作します（デフォルトはドライラン）

リソース

MCP リソースは、ツール呼び出しをせずに AI アシスタントへコンテキストを提供します。リソースに対応したクライアントは、この情報を会話に自動的に含めることができます。

リソース	説明
anilist://profile	自己紹介、統計、お気に入りを含む AniList プロフィール
anilist://taste/{type}	ANIME または MANGA の嗜好プロフィール（ジャンルの重み付け、テーマ、採点パターン）
anilist://list/{type}	進捗とスコアを含む、現在視聴中／読書中のエントリー

プロンプト

クライアントがクイックアクションとして提示できる、事前作成済みの会話スターターです。

プロンプト	説明
setup	AniList アカウントの接続手順を案内します
seasonal_review	今シーズンのアニメを、あなたの嗜好プロフィールに照らしてレビューします
what_to_watch	気分や視聴時間の予算を指定して、今見る作品を計画します
roast_my_taste	あなたのアニメの好みをユーモラスにこき下ろします
compare_us	別のユーザーとあなたの好みを比較します
year_in_review	アニメ／マンガの年間レビューを作成します
explain_title	特定のタイトルを好き（または嫌い）になる理由を説明します
find_similar	気に入った作品に似たタイトルを探します

使用例

ani-mcp を接続すると、AI アシスタントに次のようなことを尋ねられます。

「次は何を見たらいい？」 anilist_pick を使用して、視聴済みリストを分析し、嗜好プロフィールを作成したうえで、視聴予定リストから好みに合う順にタイトルをおすすめします。

「ダークで心理的な作品が見たい」 anilist_pick をムードフィルタリングとともに使用し、その雰囲気に合うタイトルを優先し、合わないタイトルの優先度を下げます。

「今シーズンのおすすめは？」 anilist_pick を source: SEASONAL とともに使用し、現在放送中のアニメを嗜好プロフィールに照らして順位付けします。

「90分あるけど、今夜は何を見たらいい？」 anilist_session を使用して、現在視聴中のリストから作品を選び、好みに最も合うエピソードで視聴時間の予算を満たします。

「視聴済み作品の続編で、今シーズンに放送されるものはある？」 anilist_sequels を使用して、視聴済みリストと今シーズンのラインナップを照合します。

「Fate はどの順番で見ればいい？」 anilist_watch_order を使用して、フランチャイズの関連グラフをたどり、番号付きの視聴順を作成します。

「username123 と好みを比較して」 anilist_compare を使用して、共通するタイトルを探し、相性スコアを計算し、意見が大きく分かれる作品を示します。

「Vinland Saga はなぜ自分に合いそうなの？」 anilist_explain を使用して、あなたの嗜好プロフィールに照らしてタイトルを採点し、ジャンルとの親和性やテーマとの一致度を詳しく説明します。

「アニメの年間レビューを見せて」 anilist_wrapped を使用して、指定した年に視聴したすべての作品をまとめます。

ムード設定

anilist_pick と anilist_session は、自由記述の mood 文字列を受け付けます。組み込みのキーワードには、dark、chill、hype、action、romantic、funny、brainy、sad、scary、epic、wholesome、intense、mystery、fantasy、scifi、trippy、nostalgic、artistic、competitive、cozy があります。

キーワードを追加または上書きするには、ANILIST_MOOD_CONFIG に JSON オブジェクトを設定します。

{
  "ANILIST_MOOD_CONFIG": "{\"cozy\":{\"boost\":[\"Slice of Life\",\"Iyashikei\"],\"penalize\":[\"Horror\"]},\"mykeyword\":{\"boost\":[\"Romance\"],\"penalize\":[]}}"
}

各キーはムードのキーワードで、{ boost: string[], penalize: string[] } の配列に AniList のジャンルとタグを指定します。

プライバシー

詳細は PRIVACY.md をご覧ください。要約すると、ani-mcp はローカルで動作し、AniList API にのみリクエストを送信します。データの保存や分析情報の収集は行いません。

Docker

docker build -t ani-mcp .
docker run -e ANILIST_USERNAME=your_username ani-mcp

デフォルトでは HTTP Stream トランスポートを使用し、ポート 3000 で動作します。

ソースからビルド

git clone https://github.com/gavxm/ani-mcp.git
cd ani-mcp
npm install
npm run build
npm test

サポート

バグ報告や機能リクエスト：GitHub Issues

ライセンス

MIT