Anteater MCP

Anteater MCP

リリース 1.0.0-beta.2 では、MCPHub の個人用と共有用を別々に設定できるようになり、HTTP ホスティングでリクエストごとに任意の上流キーを指定できるようになりました。キャッシュは認証情報ごとに分離されます。 共有サービスでは、キーが設定されていない場合、引き続き匿名で上流の割り当てを利用できます。

Claude と ChatGPT が UC Irvine での履修科目選びをサポートする MCP サーバーです。

Anteater API をラップしています。Anteater API では、UCI のコースカタログ、最新の授業スケジュール（WebSoc）、過去の成績分布、履修履歴、前提条件ツリー、AP 単位、学位要件、補足的な RMP 評価を利用できます。学生が実際に尋ねる質問に合わせて、20 個のツール、6 個のガイド付きプロンプト、4 個の参照リソースとして提供します。

実行時の依存関係はありません。 Node 24 LTS でソースを実行するか、同じ Node ランタイムを内蔵した Linux、macOS、Windows 用のスタンドアロン実行ファイルをダウンロードしてください。

"Find me a GE-2 for Fall that ends before 5pm and still has seats, ranked by how well people do."

Course        Title                Units  GPA   A%   n     SeatsOpen  Example meeting
------------  -------------------  -----  ----  ---  ----  ---------  ---------------------------
BIO SCI 17    EVO PSYCHOLOGY       4      3.80  88%  2410  2          TuTh 15:30-16:50 @ SH 134
UNI STU H30A  ANALYSIS HEALTH LIT  4      3.77  84%  864   15         TuTh 12:30-13:50 @ ALP 1600
LPS 31        INTRO INDUCT LOGIC   4      3.61  80%  2108  11         TuTh 14:00-15:20 @ EH 1200

クイックスタート

git clone https://github.com/KKazuhaK/Anteater-MCP.git
cd anteater-mcp
node --version                         # Node 24 LTS
node anteater-mcp.mjs --list-tools     # confirm it runs

続いて、クライアントに追加してください。Claude Desktop、 Claude Code、ChatGPT、または **その他の MCP クライアント**に対応しています。

ほかに必要なものはありません。API キーは任意ですが、設定をおすすめします。

インストール

スタンドアロンバイナリ

各 GitHub リリースには、amd64 および arm64 向けの Linux、macOS、Windows 用ネイティブアーカイブと、SHA256SUMS.txt が含まれています。Node.js は不要です。

# After downloading and extracting the archive for your platform:
./anteater-mcp --version
./anteater-mcp --list-tools

MCP クライアントの設定では、anteater-mcp（または anteater-mcp.exe）の絶対パスを command に指定し、args 配列は省略してください。macOS アーカイブはアドホック署名されています。Developer ID による公開署名と公証は、まだ設定されていません。

Docker

公開イメージは Linux の amd64 および arm64 に対応しています。macOS と Windows の Docker Desktop では、同じ Linux イメージが実行されます。

cp .env.example .env
# Set ANTEATER_MCP_TOKEN in .env, then:
docker compose up -d
curl -fsS http://127.0.0.1:8787/health

Compose サービスは非 root、読み取り専用、ケイパビリティなしで、デフォルトではループバックにバインドされます。パブリック HTTPS の背後に配置する前に、DEPLOY.md を確認してください。

Claude Desktop

設定ファイルを開きます。

anteater エントリを追加します。パスは絶対パスで指定する必要があります。Claude Desktop はプロジェクトディレクトリからサーバーを実行しません。

{
  "mcpServers": {
    "anteater": {
      "command": "node",
      "args": ["/absolute/path/to/anteater-mcp/anteater-mcp.mjs"]
    }
  }
}

API キーを設定する場合：

{
  "mcpServers": {
    "anteater": {
      "command": "node",
      "args": ["/absolute/path/to/anteater-mcp/anteater-mcp.mjs"],
      "env": { "ANTEATER_API_KEY": "your-secret-key" }
    }
  }
}

Claude Desktop を完全に再起動してください（ウィンドウを閉じるだけではなく、終了してください）。20 個の Anteater ツールが表示され、6 個のプロンプトがスラッシュコマンドとして表示されます。

このリポジトリにある claude_desktop_config.example.json は同じ設定内容で、そのままコピーして使えます。

Claude Code

claude mcp add anteater -- node /absolute/path/to/anteater-mcp/anteater-mcp.mjs

キーを設定する場合：

claude mcp add anteater -e ANTEATER_API_KEY=your-secret-key -- node /absolute/path/to/anteater-mcp/anteater-mcp.mjs

claude mcp list で確認してください。

ChatGPT

2 つの方法があります。1 つ目はサーバーが不要です。

node anteater-mcp.mjs --http --port 8787   # binds 127.0.0.1 only — do not add --host
# in another terminal
ngrok http 8787      # or: cloudflared tunnel --url http://localhost:8787

https://<your-domain>/mcp?token=<ANTEATER_MCP_TOKEN>

⚠️ ChatGPT の MCP プラグインは Web 専用です。 OpenAI の公式ドキュメントによると、開発者モードは「Pro、Plus、Business、Enterprise、Education アカウントのウェブ版で利用可能」です。スマートフォンアプリからは MCP サーバーに接続できません。スマートフォンで ChatGPT を使う場合は、このサーバーのREST ファサードを参照する Action を設定したカスタム GPT を使用してください。

ChatGPT の各方法で利用できる機能

スマートフォンで

Claude の iOS アプリと Android アプリは、リモート MCP サーバーに対応しています。これを HTTPS の背後にデプロイし、ブラウザーで claude.ai に一度追加すると、アプリにも同期されます。スマートフォンから新しいサーバーを追加することはできません。DEPLOY.md には、トークン認証、systemd ユニット、Caddy または nginx、コネクターのセットアップまで、手順がすべて記載されています。

ChatGPT Custom GPT の方法もモバイルで使え、サーバーは一切必要ありません。

Codex

Codex はストリーミング可能な HTTP に対応し、トークンを環境変数から読み取るため、設定ファイルにトークンが残ることはありません。

export ANTEATER_MCP_TOKEN=...   # in your shell profile
codex mcp add anteater --url https://your.domain/mcp --bearer-token-env-var ANTEATER_MCP_TOKEN

または、~/.codex/config.toml に直接書き込むこともできます。プロジェクトローカルの .codex/config.toml は、グローバルの設定ファイルより優先されます。

[mcp_servers.anteater]
url = "https://your.domain/mcp"
bearer_token_env_var = "ANTEATER_MCP_TOKEN"

Codex は接続時に変数を読み取り、Authorization: Bearer <token> を送信します。

その他の MCP クライアント

このサーバーは、stdio 経由で標準の MCP に対応しています。クライアントの接続先を次のように指定してください。

command: node
args:    ["/absolute/path/to/anteater-mcp/anteater-mcp.mjs"]

または、node anteater-mcp.mjs --http を実行して、http://127.0.0.1:8787/mcp でストリーミング可能な HTTP サーバーとして起動してください。

プロトコルバージョン 2025-06-18、2025-03-26、2024-11-05 に対応しています。送信されたバージョンをそのまま返すのではなく、サーバーが対応可能な古いバージョンへ調整します。

利用できる機能

ツール（20 個）

授業を探す

履修前に授業を見極める

実際に履修登録できるかを確認する

学位取得を計画する

このうち 5 つのツールは、上流の API が提供していない処理を行います。前提条件ツリーの評価、時間割の重複検出、開講中の時間割と過去の成績データの結合、AP 単位の付与内容の表示、学位取得の進捗の確定的な評価です。

20 個すべてに readOnlyHint: true が注釈されています — ここでデータが変更されることはありません。

プロンプト（6）

Claude Desktop では、これらはスラッシュコマンドとして表示されます。それぞれが単一の検索ではなく、複数のツールを使った一連のワークフローを実行します。

* = 必須です。term、ge、department、major、course という名前の引数は、MCP completions API による自動補完に対応しています。

リソース（4）

クライアントがツール呼び出しを使わずに直接読み取れる参照テーブルです。

• anteater://reference/departments — すべての学科コードと名称
• anteater://reference/terms — スケジュールデータを含むすべての学期
• anteater://reference/ge-categories — GEコードとその意味
• anteater://reference/restriction-codes — Registrar による履修制限コード

設定

APIキー

任意ですが、設定をおすすめします。匿名呼び出しは共有の時間あたりのクォータを消費するため、すぐに使い切る可能性があります。キーを設定すれば、自分専用のクォータを利用できます。

ファジー検索が有効になるわけではありません。/v2/rest/search は通常のキーを not permitted to access this resource というエラーで拒否します。この検索には、ICSSC が別途付与する上位の権限が必要です。権限がない場合、search_courses はタイトル、次に説明文に対する部分一致検索にフォールバックし、そのことを出力に示します。構造化フィルター（department、geCategory、courseLevel、単位数）には影響せず、通常はこちらのほうが適しています。

1. dashboard.anteaterapi.com/create にアクセスします
2. タイプとして secret を選択します。publishable キーは Origin ヘッダーに対して検証されますが、Node はこのヘッダーを送信しないため、ここでは使用できません
3. クライアント設定にキーを設定するか（上記を参照）、ローカル開発の場合は次のように設定します。

cp .env.example .env     # then edit .env
set -a; . ./.env; set +a # load it without echoing the value

.env は gitignore の対象です。キーを Issue、PR、スクリーンショットに貼り付けないでください。

共有および個人用の上流キー（MCPHub）

MCPHub 内で直接実行するには、MCPHub ガイドの stdio 設定をインポートします。各ユーザーは個人用キーを紐付けることができ、別の共有エントリでは公開キー／デフォルトキーを使用します。Anteater コンテナを別途用意する必要はありません。以下のヘッダー方式は HTTP デプロイ用です。

HTTP 呼び出しでは、デプロイ時に設定した共有 ANTEATER_API_KEY と、X-Anteater-Api-Key で送信する個人用キーのどちらも使用できます。個人用ヘッダーは、そのリクエストに関連するすべての並行上流呼び出しを含め、優先して使用されます。ヘッダーがない場合は共有キーが使用されます（共有キーが設定されていなければ、匿名で上流にアクセスします）。空の個人用ヘッダーや曖昧な個人用ヘッダーは拒否されます。無効な個人用キーが共有キーを使って再試行されることはありません。Anteater API のキャッシュは認証情報ごとに分離されています。

Authorization: Bearer <ANTEATER_MCP_TOKEN> は、引き続きこのサーバーへのアクセスを認証します。これは上流 API キーとは独立しており、設定されている場合はどちらのモードでも必要です。個人用キーはヘッダーに設定し、URL のクエリパラメーターには決して含めないでください。

共有サーバーと個人用サーバーの個別のエントリについては、MCPHub のセットアップを参照してください。個人用エントリにはキーの紐付けが必要です。共有エントリは紐付けなしで引き続き利用できます。

環境変数

コマンドライン

node anteater-mcp.mjs                    # stdio (what MCP clients use)
node anteater-mcp.mjs --http             # HTTP on 127.0.0.1:8787, endpoint /mcp
node anteater-mcp.mjs --http --port 9000 # different port
node anteater-mcp.mjs --http --host 0.0.0.0  # bind all interfaces (warns; see below)
node anteater-mcp.mjs --list-tools       # list every tool

HTTP モードのセキュリティ

• デフォルトでは 127.0.0.1 にバインドします。 ホストを指定せずに server.listen(port) を実行すると、すべてのインターフェースにバインドされ、認証されていないサーバーが LAN 全体に公開されてしまいます。変更するには --host が必要です。変更時には警告が表示されます。
• Origin を検証します。 MCP 仕様では、ローカル HTTP サーバーにこの検証が求められています。検証しないと、アクセスしたページからポートに POST して、すべてのツールを操作できてしまいます（DNS リバインディング／CSRF）。Origin がないリクエスト（ネイティブ MCP クライアント）は許可されます。Origin があるリクエストは、localhost からのものか、ANTEATER_ALLOWED_ORIGINS に指定されている必要があります。
• Access-Control-Allow-Origin は検証済みの単一のオリジンを返し、* は決して返しません。
• ANTEATER_MCP_TOKEN が設定されていない場合、HTTP リクエストは認証されません。 ループバックでは問題ありませんが、それ以外の場所では安全ではありません。ループバック以外にバインドしていてトークンが設定されていない場合、サーバーは起動時に警告を表示します。DEPLOY.md を参照してください。
• HTTP のアクティビティは、1 リクエストにつき JSON のリクエスト行とレスポンス行として stderr に記録されます。 ログにはリクエスト ID、メソッド、無害化されたターゲット、リモートアドレス、ステータス、所要時間、RPC／ツール名、および取得可能な場合は結果が含まれます。認証情報と RPC 引数は記録されません。URL 内のトークン値は [REDACTED] と表示されます。
• /health はステータスとソース URL を返します。/source はこのリポジトリにリダイレクトします。これにより、変更したコピーをデプロイする人が AGPL 第 13 条を遵守しやすくなります。

トラブルシューティング

開発

npm test                # 20 conformance tests; makes no API calls
npm run test:live       # live calls; needs a key in practice
npm ci                  # build tooling only; the shipped server has no runtime packages
npm run build:sea       # standalone binary; requires the exact Node in .node-version

UPSTREAM.md には、正確な Anteater API のバージョンと、このサーバーがエンドポイントごとに検証された上流コミットが記録されています。API が変更され、結果が誤っていたり空になったりした場合は、ここから確認してください。

VERIFICATION.md はリリース用の完全なチェックリストです。回帰テストの合格基準、セキュリティチェック、統合チェックがまとめられており、コードを読んだことがない人でも実行できるように書かれています。

CI では、Docker とネイティブパッケージングで使用しているものと同じ、固定バージョンの Node 24 LTS リリースを使用します。オフラインテストスイート、構文チェックと OpenAPI チェック、スタンドアロン実行ファイルのスモークテスト、制限されたコンテナーでのプロトコルテストを実行します。意図的に Anteater API へのライブ呼び出しは行わないため、公開レート制限を消費することはありません。

package.json のバージョンに v を付けた文字列と完全に一致するタグをプッシュすると、6 つのネイティブ実行ファイルをビルドし、チェックサムと来歴の証明を生成し、amd64/arm64 イメージを GHCR にプッシュして、GitHub Release を公開します。安定版タグでは :latest が更新され、すべてのリリースで :beta が更新されます。正確な :vX.Y.Z タグは変更されません。

初回のイメージ公開後、GHCR パッケージの公開範囲を一度だけパブリックに設定してください。ワークフローではスコープが限定された GITHUB_TOKEN を使用します。リポジトリのポリシーによってボットが作成する Release がブロックされる場合は、上流プロジェクトのフォールバックと同様に、Contents への書き込み権限を持つきめ細かい RELEASE_PAT シークレットを追加してください。

対象範囲

Anteater API は、食堂、図書館の利用状況、学習室の予約にも対応しています。これらは意図的にラップしていません。このサーバーは、授業の選択と履修登録に専念しています。

LARC の個別指導セクションは対象範囲に含まれますが、上流では実質的に停止しています。/v2/rest/larc は 2024 年秋学期のコースを 22 件返しますが、それ以降の学期には何も返さないため、学生が実際に計画している学期について、ツールは常に「該当なし」と回答することになります。

既知の制限事項

これらは上流データの特性であり、バグではありません。誤った助言を自信たっぷりに提示するよりも、サーバーはこれらの制限を明示します。

• WebSoc では、どのディスカッションがどの講義に属するかは公開されていません。 コースによってはセクション番号に対応関係が含まれています（Lec A → Dis A1）が、別のコースでは関連するセクションが独立して番号付けされています（I&C SCI 31：講義は A/B、ラボは 1〜9）。そのため、check_schedule は必須の構成要素が完全に欠けている場合や、組み合わせを確認できない場合を知らせますが、特定のラボが特定の講義に対応しているとは確認できません。WebReg で確認してください。ICSSC 独自のクライアントも、どちらもこの対応関係を推測しません。AntAlmanac と PeterPortal はどちらもセクションをフラットなリストとして表示し、組み合わせの確認は学生に委ねています。これは、対応関係を示すデータ自体が存在しないことの有力な証拠です。
• 履修制限があなたに適用されるかどうかは判定されません。 search_sections と recommend_courses は制限コードとその意味を表示しますが、「専攻限定」や「大学院生限定」の条件を満たしているかどうかは、教務課が判定します。
• 編入単位やコミュニティカレッジでの履修科目は含まれていません。 check_prerequisites は、認識できない修了済み科目を黙って無視せずに報告しますが、編入単位を認定できるのはアドバイザーだけです。
• 履修登録期間の日付はありません。 学事暦には授業期間と期末試験期間が記載されていますが、履修登録期間の開始日は記載されていません。StudentAccess で確認してください。
• 成績データには遅れがあります。 直近のクォーターのデータがない場合があり、最近の学期の成績が STAFF 名義で登録されていることもよくあります。サンプル数が少ないと平均 GPA の信頼性は低くなります。ツールは常に n を表示するので、信頼性を判断できます。
• 過去の GPA はコース全体の平均です。 recommend_courses は過去のすべての担当教員の平均に基づいて順位付けしますが、その教員が今学期の担当教員とは限りません。決める前に get_course_grades を使って担当教員ごとの成績を確認してください。

リリース前に発見して修正したバグ

6つの観点（ロジック、MCP 準拠、ライブ API 契約、セキュリティ、堅牢性、リポジトリの準備状況）から並行レビューを行い、修正前に41件、重複を除いて38件の指摘がありました。実際に利用者を誤解させていたであろう問題は次のとおりです。

2回目のレビューでは、現実的な学生のシナリオを6件想定し、サーバーを最初から最後まで動作させたところ、さらに54件の問題が見つかり、そのうち10件は重大な障害でした。特に深刻なものは次のとおりです。

そのほか、NOT の前提条件サブツリーでチェックマークが逆になる問題、スペースを含む48個の学科コードで科目番号が失われる問題、HTTP のチャンク境界でマルチバイト UTF-8 が破損する問題、未検証の入力に対して二次的なバックトラッキングを起こす正規表現、socAvailable が時間割の公開日であるにもかかわらず「履修登録開始日」と誤表示される問題も修正しました。

知っておくと便利な API の癖

上流のドキュメントには記載されていませんが、ここではすべて対応しています。デバッグに役立つ場合に備えて記載します。

• days はカンマ区切りにする必要があります。 Tu,Th は機能しますが、TuTh は拒否されます。指定した曜日の少なくとも 1 つに一致し、すべてに一致するわけではありません。
• enrollmentHistory はスカラー値ではなく、並列配列を返します（dates[]、totalEnrolledHistory[]、requestedHistory[] など）。-1 は「追跡されていない」ことを意味します。
• finalExam.month は 0 始まりです。
• コースのコメントは生の HTML フラグメントで、<p> や " も含まれます。
• startTime / endTime は「開始時刻が指定時刻以降」「終了時刻が指定時刻以前」を意味し、時間帯の重複を意味するわけではありません。
• /v2/rest/search には 特権付き API キーが必要です。 通常のキーでは not permitted to access this resource として拒否されます。これは、キーがまったくない場合に表示される key is required とは別のエラーです。すでにキーを持っている人にキーを取得するよう伝えても行き詰まるため、この違いを把握しておくと便利です。
• **/v2/rest/websoc/syllabi が受け取るのは courseId**であり、department と courseNumber ではありません。
• /v2/rest/courseMaterials には department と courseNumber の両方が必要です。 どちらか一方だけでは拒否され、夏の 3 つのセッションは単一の Summer にまとめられます。
• 制限の文字列には文章が含まれます。 "A and N" は空白で分割し、文字どおりの and / or も取り除く必要があります。そうしないと、接続詞がコードとして表示されます。
• セクションのステータスは自由記述ではなく列挙値です：OPEN、Waitl、FULL、NewOnly、または空です。継続在学生が今すぐ登録できるのは OPEN の場合だけです。NewOnly は新入生向けに確保された席を示します。numNewOnlyReserved は、同じ方法で確保された定員内の席数を示すため、見かけ上の空席数は実際の空席数より多くなります。

配布

MCP Registry に io.github.KKazuhaK/anteater-mcp として公開されており、コンテナイメージのみを掲載しています。レジストリエントリには独自のインスタンスの実行方法が記載されています。ホスト型インスタンスはそれぞれ独自のトークンで保護され、その上流クォータは実行者に属するため、他者のデプロイ先にはリンクしていません。

各リリースでは、GHCR イメージと 6 つのプラットフォーム向けのスタンドアロンバイナリも公開されます。

ライセンスと帰属表示

データは ICSSC Projects が保守する Anteater API から取得しています。

これは UCI の公式ツールではありません。 登録前に WebReg または General Catalogue で確認してください。利用には Anteater API の帰属表示ポリシーが適用されます。

上流の Anteater API サーバーと同じ AGPL-3.0-or-later ライセンスを採用しています。これにより、将来このプロジェクトが上流に取り込まれる場合、コードを双方向に自由に移動できます。これは独立した HTTP クライアントであり、上流のソースコードは含まれていません。このプロジェクトを変更してネットワークサービスとして実行する場合、AGPL 第 13 条により、ユーザーに Corresponding Source を提供する必要があります。詳しくは NOTICE を参照してください。

学術利用の場合：

@misc{anteater-api,
  author = {ICS Student Council},
  title = {Anteater API},
  year = {2024},
  howpublished = {\url{https://github.com/icssc/anteater-api}},
}