ManageBac MCP Server

AI エージェント（Claude Code、Claude Desktop、OpenCode、ChatGPT など）があなたの ManageBac アカウントを読み取り、操作できるようにするローカル MCP サーバーです。期限、成績、お知らせ、リソース、課題提出に対応しています。

実際のブラウザウィンドウでログインし（一度サインインするだけ）、セッションをローカルに保存して再利用します。パスワードが保存されたり、どこかに送信されたりすることは決してありません。

ツール

• managebac_get_classes — クラスの一覧を取得します

• managebac_get_all_deadlines / managebac_get_class_deadlines — 今後、過去、期限超過のタスクを取得します

• managebac_get_grades / managebac_get_class_grades / managebac_get_recent_class_grades — 成績の記録を取得します

• managebac_get_gpa / managebac_get_class_gpa — ページに表示されている GPA を取得します（推定値ではありません）

• managebac_get_class_grade_weights — クラスのカテゴリ別重み付けを取得します

• managebac_get_announcements — 学校とクラスのページからお知らせ・通知を取得します

• managebac_get_class_resources — クラスのダウンロード可能なファイル・リソース（授業内容、教材）を取得します

• managebac_download_file — ファイル（添付ファイルまたはリソースの href）を base64 としてダウンロードします

• managebac_get_assignment_details — 1つの課題のルーブリック、指示、添付ファイルを取得します

• managebac_submit_assignment — 課題にファイル（ディスクから、またはローカルファイルにアクセスできない ChatGPT などのクライアントでは base64）またはテキストを添付します。常に最初にドライランを実行します。

• managebac_get_cas_info / managebac_get_ee_info — ロック解除後に CAS / Extended Essay の振り返りを取得します

• managebac_check_session / managebac_runtime_info — セッションの健全性とプロセス診断情報を取得します

• managebac_list_links / managebac_debug_snapshot — ページパスを見つけるためのデバッグ用ヘルパーです

お知らせとリソースの取得はベストエフォートです。ManageBac のページ構造は学校によって異なるため、結果が少ない場合は、エージェントに managebac_list_links または managebac_debug_snapshot を使用して適切なページを見つけ、path として渡すよう依頼してください。

Related MCP server: Chrome MCP Server

インストール

Node.js 20 以上が必要です。

git clone https://github.com/DH4410/managebac-mcp-server.git
cd managebac-mcp-server
npm install
npm run build
npm run install-browser   # first time only, installs Chromium for Playwright

env ファイルをコピーして、あなたの学校の ManageBac URL を設定してください：

cp .env.example .env

MANAGEBAC_BASE_URL=https://your-school.managebac.com

一度だけログインします（実際のブラウザウィンドウが開き、セッションを保存して閉じます）：

npm run login

AI エージェントに接続する

ほとんどの MCP クライアント（Claude Code、Claude Desktop、OpenCode、Cursor）は MCP サーバーをローカルプロセスとして実行します。MCP 設定に次のようなものを追加してください：

{
  "mcpServers": {
    "managebac": {
      "command": "node",
      "args": ["/absolute/path/to/managebac-mcp-server/dist/index.js"],
      "env": {
        "MANAGEBAC_BASE_URL": "https://your-school.managebac.com",
        "MANAGEBAC_STORAGE_STATE": "/absolute/path/to/managebac-mcp-server/.managebac/storage-state.json"
      }
    }
  }
}

特に Claude Code では、リポジトリのルートにある .mcp.json にこれを追加し、/mcp を実行してサーバーを承認してください。

ChatGPT に接続する

ChatGPT は URL 経由でしか MCP サーバーに接続できません（ローカルプロセスには対応していません）。そのため、ローカルサーバーには、保護のための一時的な公開 URL と秘密トークンが必要です。ManageBac のログイン情報は依然としてあなたのマシンから出ることはありません — トンネルを通過するのはツールの応答だけであり、それも使用中だけです。

最も簡単な方法 — コマンド1つ：

npm install cloudflared   # one-time; downloads the cloudflared binary (~40MB)
npm run chatgpt

これにより、サーバーがビルドされ、HTTP モードで起動し、Cloudflare のクイックトンネルが開かれ、次のようなブロックが表示されます：

=================================================
 ChatGPT connector settings
=================================================
 URL:   https://random-words.trycloudflare.com/mcp
 Auth:  Bearer token
 Token: 9f2a1c...
=================================================

ChatGPT で：設定 → コネクタ → 詳細/開発者モード → コネクタを追加 を選択し、URL を貼り付けて、認証を表示されたトークンを使用した Bearer トークンに設定します。

ChatGPT にアクセスさせたい間はターミナルを開いたままにしてください。閉じる（または Ctrl+C）と、トンネルとサーバーの両方が停止します。URL とトークンはコマンドを実行するたびに新しいものになるため、再起動後は ChatGPT に再貼り付けしてください。

手動の方法（cloudflared パッケージを追加したくない場合）：.env に MCP_TRANSPORT=http、MCP_HTTP_PORT=3939、MCP_HTTP_TOKEN=<a long random value> を設定し、npm start を実行します。次に、任意の HTTPS トンネルツール（たとえば、cloudflared を別途インストール済みの場合は cloudflared tunnel --url http://localhost:3939）をポート 3939 に向け、ChatGPT でも同様に <tunnel-url>/mcp とトークンを使用します。

注意事項

• .env と .managebac/（保存されたセッション）は git の無視対象です。絶対にコミットしないでください。

• コードを編集したり再ログインしたりした場合は、MCP クライアントを再起動して、新しいプロセスを認識させてください。

• ManageBac がアカウントをロックした場合は、自動ログインの再試行をやめて、代わりに npm run login（手動）を使用してください。

トラブルシューティング

期限や GPA が正しくないように見える場合は、デバッグツールを使用して、スクレイパーが何を見つけているかを確認してください：

managebac_list_links({ "match": "task" })
managebac_debug_snapshot({ "path": "/student/tasks_and_deadlines?view=upcoming" })

オプション：自動パスワードログイン

デフォルトではオフです（手動ログインの方が安全です）。有効にするには、.env に設定してください：

MANAGEBAC_LOGIN_MODE=password
MANAGEBAC_EMAIL=your.email@example.com
MANAGEBAC_PASSWORD=your-password