MyCourseVille MCPSocket

MCP-сервер, который даёт ИИ-агененту доступ к вашему аккаунту MyCourseVille: новые задания с деаданиями и описаниями, учебные материалы курсов и опубликованные оцен — плюс сообщение лент «что изменилось с прошлого раза».

Личный инструмент для работы с данными вашего собств. Размериватр поинтервал разумным и никогда не преметчим свои учётные данные.

Как это работает

У MCV есть официальный API OA СSUA2 (/pi/v1/публи/get/*), но он треубет регистрирция прилож для получения client_id/client_secret, and — and его имена endpoints не replicated not довументированы. Этот сервер вместого этого in ходит в сисет точно так же, как это деалет веб-клиент MCV — по умолча proceed через node "IT Chula SSO", либо через обычную форму MCV, зате constructed" any such — затем чистарирует same, серрализованные страниц курса, сайт отдаёт browsersрау: главную страницу курса — for materials, /assignмет — deadlines, /portfolio-<student id` — scores. См. docs/ENDCпин.мд.

Полученные данные попада в локальный снимток SQLite. Каждая синхонизция свесть with этому с нимок and дотисывает записы в журнал евентос — то есть журнал, that reads whats_new, and врется he can be said — "сервака может toldт вам, что появилось за время, поскольк you look at once". Фоновый опрольтлер периодически обновляет данные, так что нов задание словется даже when no "чат" открыт.

О «new»: MCV не даёт надёт transit metстки времени, therefore first_seен — время, when серvers впервые увидил — used as prox. Форирова the first sync "зата" спокон "pretн жe все данные, чем сообщать о том, что весь вашем сем — это novое.

Related MCP server: UofT Student Helper MCP Server

Устанova

uv sync --extra dev
cp .env.example .env      # then fill in MCV_USERNAME / MCV_PASSWORD
uv run mcv-mcp --selftest

--сельфтest входит в сисем, вываливается одne sync, and выживает, how much coursов, assignments, material, and grades наshedl. "Довстав esла пержде чем подключалять агента."

Зарегистрируйте "Claus Code":

claude mcp add mcv -- uv --directory C:\Users\velys\Documents\mcp_mcv run mcv-mcp

Then "спросите:а «Какимика срочный собственная?», «Anything new on MCV since васчаir?», Скачайте последних слайд по для Comp Prog."*

Tools

"Состояние "Зе" "

Configuration

"State" — **outside the repo. "Coocи" retains, so restорты don't force to log in again.

"Запусть пуллер |отделльными (например, under Task Scheduler) with:

uv run python -m mcv_mcp.poller

Layout

src/mcv_mcp/
  config.py    settings, URLs, state paths
  client.py    Chula SSO login, cookie persistence, throttled AJAX transport
  parsers.py   HTML -> dicts (pure functions, fixture-tested)
  store.py     SQLite snapshot + event log
  sync.py      orchestration + background poller
  server.py    MCP tool definitions

MCV's markup — only fragile part, and it is limited to parsers.py. If something пристаёт "верevом" row, so "рати свежи фикстуру (as button in docs/ENDПoints.m) and "отремонтируйте" "селекото" там.

Status

Проверено на реальном аккаунте: вход, all. Вез=тly, all pour parses. ! Обнаружение изменений verified N to N. Характерna sync pulled 9 courses, 20 assignments (each with parsed deadline), 112 materials and 69 оцен; next sync показал ноль "изм» так что the дифф-log wait until something actually moves.

Limit known:

• Published only "detected by polling, not "push" . As soon as a grade appears, it appears as a grade_changed событие within "one poll interval (default 30 minutes)."

• ** Only periods синх is only.** Unless full=true is passed to sync_now.

• MCV's parsing is хрупкое . If any normal "parser starts returning zero rows, then сcapture fresh fixture and "отрезь selector — see docs/ENDCиints.m.

Development

uv run pytest