Ani MCP

🎬 ani-mcp

あなたのアニメ・マンガの好みを理解する、AniList向けのスマートなMCPサーバー — 単なる生のAPIコールではありません。

✨ ani-mcpの違い

ほとんどのAniList連携はAPIを1:1で反映するだけです。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_TOKEN が必要）

📚 リソース

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

💬 プロンプト

クライアントがクイックアクションとして提供できる、あらかじめ用意された会話のきっかけ。

💡 使用例

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

「次は何を見るべき？」 anilist_pick を使用して完了リストを分析し、好みのプロファイルを構築し、Planningリストからあなたの好みにどれだけ合うかでランク付けしたタイトルを推薦します。

「ダークで心理的な作品が欲しい」 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\":[]}}"
}

各キーはムードキーワードで、AniListのジャンルとタグの配列 { boost: string[], penalize: string[] } にマッピングされます。

🔒 プライバシー

詳細は PRIVACY.md を参照してください。要するに：ani-mcpはローカルで動作し、リクエストはAniList APIにのみ送信され、何も保存せず、分析データも収集しません。

🐳 Docker

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

デフォルトでポート3000のHTTP Streamトランスポートで動作します。

🔨 ソースからビルド

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

💬 サポート

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

📄 ライセンス

MIT