animeport

animeport

animeport は AniList を使用して、アニメやマンガに関する質問に回答します。作品のあらすじや評価、制作した人物、今日が誕生日のキャラクターやスタッフ、特定のユーザーが視聴または読んでいる作品、あるタイトルのファンが次に薦める傾向のある作品などを確認できます。回答はすべて AniList の公開 GraphQL API から取得されます。

このパッケージはクリーンルームで再構築したもので、ラベル付きのコアサブセットです。元の AniList MCP サーバー向けに記載された42個のツールのうち、20個に対応しています。省略したツールは、以下の「対象範囲」に記載されています。

サービスとの通信方法

各ツールは AniList API に POST で GraphQL クエリを1つだけ送信し、レスポンスの data ペイロードを返します。

# Optional: raises rate limits / unlocks authenticated reads on AniList.
export ANILIST_TOKEN="your token"
# Optional override (default: https://graphql.anilist.co)
export ANILIST_API_URL="https://graphql.anilist.co"

トークンは実際に省略可能です。トークンが設定されていない場合、キーなしでリクエストが送信されます。AniList はこれらの読み取りツールについてキーなしのリクエストを受け付けるため、ANILIST_TOKEN が未設定という理由だけで失敗することはありません。AniList が GraphQL の errors 配列を返した場合、呼び出しは最初のエラーのメッセージとともに失敗します。上流の HTTP エラーは、ステータスと本文の抜粋とともに報告されます。

フィールド選択に関する注記： 元のプロジェクトの README には、ツールとその目的が記載されていますが、GraphQL のフィールド選択は記載されていません。ここにあるクエリは、各ツールに示された目的に合わせて新たに妥当な形で再構築したものであり、元のクエリをコピーしたものではありません。

インストール

npx @reneturcios/animeport search_anime '{"search":"Frieren"}'

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/animeport

コンテナはデフォルトで MCP サーバーとして起動します。CLI として使用するには、CLI 引数を渡してください。

CLI

CLI はツールに対応しており、ツールごとに1つのサブコマンドがあり、引数は単一の JSON オブジェクトとして受け取ります。

animeport get_genres '{}'
animeport search_anime '{"search":"Frieren","perPage":5}'
animeport get_anime '{"id":154587}'
animeport get_todays_birthday_characters '{}'
animeport get_user_anime_list '{"username":"someone","status":"CURRENT"}'
animeport get_recommendations_for_media '{"mediaId":154587}'
animeport --version

終了コード：成功時は 0、API または検証エラー時は 1（エラー内容を示します）、使用方法のエラー時は 2 です。

MCP サーバー

どちらの用途にも1つの実行ファイルを使用します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/animeport mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "animeport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/animeport", "mcp"],
      "env": { "ANILIST_TOKEN": "your token (optional)" }
    }
  }
}

ツール

ツール	入力	機能
get_genres	—	AniList で利用できるジャンルの一覧を取得します。
get_media_tags	—	AniList で利用できるメディアタグの一覧を取得します。
get_studio	id および／または name（少なくとも一方が必要。ローカルで検証）	AniList ID または名前でスタジオの詳細を取得します。
search_anime	search、page、perPage、genre、seasonYear（すべて省略可能）	タイトル、ジャンル、またはシーズンの年でアニメを検索します。
search_manga	search、page、perPage、genre、seasonYear（すべて省略可能）	タイトル、ジャンル、またはシーズンの年でマンガを検索します。
search_character	search（必須）、page、perPage	名前でキャラクターを検索します。
search_staff	search（必須）、page、perPage	名前でスタッフを検索します。
search_studio	search（必須）、page、perPage	名前でスタジオを検索します。
search_user	search（必須）、page、perPage	ユーザー名で AniList ユーザーを検索します。
get_anime	id（必須）	AniList ID でアニメの詳細情報を取得します。
get_manga	id（必須）	AniList ID でマンガの詳細情報を取得します。
get_character	id（必須）	AniList ID でキャラクターの詳細情報を取得します。
get_staff	id（必須）	AniList ID でスタッフメンバーの詳細情報を取得します。
get_todays_birthday_characters	—	今日が誕生日のキャラクターを取得します。
get_todays_birthday_staff	—	今日が誕生日のスタッフメンバーを取得します。
get_user_anime_list	username（必須）、status	ユーザーのアニメ一覧を取得します。必要に応じてステータスで絞り込めます。
get_user_manga_list	username（必須）、status	ユーザーのマンガ一覧を取得します。必要に応じてステータスで絞り込めます。
get_user_profile	username（必須）	ユーザーの AniList プロフィールを取得します。
get_user_stats	username（必須）	ユーザーの活動統計を取得します。
get_recommendations_for_media	mediaId（必須）、page、perPage	AniList ID を指定して、メディア項目のおすすめを取得します。

対象範囲

このコアサブセットには、get_site_statistics、get_activity、 get_user_activity、post_message_activity、post_text_activity、 delete_activity、add_list_entry、remove_list_entry、 update_list_entry、favourite_anime、favourite_manga、 favourite_character、favourite_staff、favourite_studio、 get_recommendation、get_thread、get_thread_comments、 delete_thread、get_full_user_info、get_authorized_user、 follow_user、update_userは含まれません。除外された機能は意図的に、 ログイン、書き込み、お気に入り、スレッドに関する機能です。animeportは 設計上、読み取り専用です。カタログデータ自体はAniListのものであり、このパッケージが 再現するのはツールの仕様とリクエスト／レスポンス処理であって、 AniListのデータベースではありません。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, fake fetch only, no network
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSEを参照してください。