ManageBac MCP Server
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: agentify-desktop
インストール
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 Playwrightenv ファイルをコピーして、あなたの学校の ManageBac URL を設定してください:
cp .env.example .envMANAGEBAC_BASE_URL=https://your-school.managebac.com一度だけログインします(実際のブラウザウィンドウが開き、セッションを保存して閉じます):
npm run loginAI エージェントに接続する
ほとんどの 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-passwordTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Browz hosted MCP (free public beta): let an AI app drive your own Browz browser profiles from anywhere. Connect https://mcp.gobrowz.com/mcp and sign in with your Browz account (OAuth) or an agent token. Each call is relayed to the Browz app on your computer, which must be online with Remote control on and have a hardware security chip (Mac Secure Enclave or TPM 2.0). 17 tools: profiles, tabs, navigate, snapshot, act, wait, screenshot. Cookies, downloads and stored sign-ins stay on your computer.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation, and network monitoring directly within your daily Chrome environment.MIT

agentify-desktopofficial
AlicenseNot gradedqualityDmaintenanceMCP server that enables AI tools to control local browser sessions for ChatGPT, Claude, and other AI services, supporting querying, navigation, file uploads, and artifact management.575Mozilla Public 2.0- AlicenseAqualityDmaintenance使AI代理能够通过学生账号读取ManageBac中的截止日期、成绩条目和GPA的MCP服务器。121ISC
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to read Google Classroom data—including coursework, submissions, announcements, and Drive attachments—through a remote, OAuth-protected MCP server with interactive Google sign-in.-