Anime MCP Server

Annict REST APIを使い、アニメの検索・人物・団体・スタッフ・放送予定の取得を行う Model Context Protocol (MCP) サーバーです。

必要なもの

• Node.js 22+

• Annict のアクセストークン（アプリ設定で発行）

Related MCP server: Bangumi MCP

セットアップ

npm install
cp .env.example .env
# .env に ANNICT_ACCESS_TOKEN **を設定**
npm run build

環境変数

ANNICT_ACCESS_TOKEN（必須）— Annict API のアクセストークン。アプリ設定で取得。.env に書くか、MCP 設定の env で渡す。

提供ツール

作品（works）

シリーズ（series）

エピソード（episodes）

人物（people）

団体（organizations）

スタッフ（staffs）

放送予定（programs）

Cursor / Claude Desktop での使い方

MCP サーバーとして登録します。

Cursor の MCP 設定、または Claude Desktop の claude_desktop_config.json に追加例:

{
  "mcpServers": {
    "anime": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/anime-mcp/build/src/index.js"],
      "env": {
        "ANNICT_ACCESS_TOKEN": "your_annict_token"
      }
    }
  }
}

/ABSOLUTE/PATH/TO/anime-mcp をプロジェクトの絶対パスに置き換えてください。トークンは env で渡すか、プロジェクト直下に .env を置いても読み込まれます。

プロジェクト構成

• src/api/ — Annict API クライアント（client.ts + works, series, episodes, people, organizations, staffs, programs）

• src/types/ — リクエスト型（api.ts, common.ts）と各リソースの型・Zod スキーマ

• src/tools/ — MCP ツール登録（リソースごと 1 ファイル）

• src/utils/format/ — リソース別テキスト整形（common.ts + 各リソース）

• src/utils/result.ts — ツール返却（ok / err / wrap）

• test/ — ユニットテスト（Vitest）。test/api/, test/utils/, test/tools/ で src と対応

開発

npm run build        # ビルド (tsc + tsc-alias)
npm start            # ビルド済み index.js を実行
npm run dev          # tsc --watch
npm test             # ユニットテスト実行 (Vitest)
npm run lint         # ESLint
npm run lint:fix     # ESLint 自動修正
npm run format       # Prettier でフォーマット
npm run format:check # フォーマットチェック

参考

• Annict REST API

• MCP（Server concepts / Build a server）