uplus-mcp
This MCP server automates and audits QingSoft U+ learning-platform workflows while also providing a generic CDP browser toolset.
Sign in manually or automatically, check login status, and launch/attach to Edge or Chrome.
List courses, homework, and experiments, including submission status and IDs.
Inspect homework, answer objective questions, capture figure-question screenshots, upload attachments, audit submitted homework, and repair missing/partial answers.
Download experiment materials/templates, inspect experiment authoring briefs, generate/fill reports, run compliance checks, upload/submit reports, and audit submitted reports.
Run patrols that produce Markdown reports, answer/repair briefs, and human-takeover lists.
Drive arbitrary web pages with generic tools for opening, snapshotting, clicking, filling, typing, pressing keys, scrolling, extracting text, evaluating JavaScript, screenshots, tab management, and batched actions.
Release the browser session when done.
Provides browser automation through CDP for an installed Chrome or Edge browser, including launching with a dedicated profile and debug port, opening pages, taking snapshots, clicking, filling forms, typing, pressing keys, scrolling, capturing screenshots, evaluating JavaScript, and managing tabs as a generic fallback for web interactions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@uplus-mcp patrol my U+ courses and answer any pending objective homework"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
uplus-mcp
PyPI publication is pending: until
uplus-mcpappears on PyPI, install from the GitHub Release wheel or clone the source (see Quick start below).
MCP server for the QingSoft U+ learning platform with a built-in generic browser toolset.
See README.zh.md for the full Chinese guide, and rename.md for the step-by-step script an AI agent follows when onboarding a new user.
What's new in 0.8.3
A full live run (login → list → generate → verify → upload → submit) exposed two things: reports carried the handbook's own wording instead of what the student actually did, and a submission that the page called successful was not kept by the server. Suite is 334 passed, 1 skipped.
Report bodies hold real work, not handbook text.
answer_experimentused to merge the sections derived from the manual straight into the report; the handbook now comes back as anauto_sectionshint and is never written into the document. Missing sections are reported as missing — nothing is invented.A generated report carries the teacher cover. With no template found, the built-in skeleton had no cover, so the compliance gate blocked it and no experiment could ever be submitted.
generate_report(..., cover=...)writes school / 实验报告 / 实验名称 / 专业 / 班级 / 学号 / 姓名 / 辅导教师 / 实验时间 / 学时数; a blank value keeps its label so the gate warns about a fillable field instead of a missing one. New config keysstudent_school,student_major,student_class,student_teacherstay in the gitignored personal config.No empty headings or scaffold labels. The skeleton used to hardcode 「(此处填写算法伪代码与实现代码)」「算法伪代码:」「实现代码:」 「时间复杂度分析:」「测试用例结果:」and an empty 「实验报告要求」 chapter. Each section is now one empty slot, and
_prune_empty_sectionsremoves any heading whose body stayed empty after filling.Long bodies split at sentence boundaries, so nothing trips the 180-character layout check.
Two compliance fixes. Item 4 no longer hardcodes 「多出实验内容」 (it fired on templates that do carry that chapter); item 5 now reports 「手册要求未能解析,本项未核对」 instead of silently passing when no requirement could be parsed.
A submission counts only after a server-side re-check. The page showed 已提交 + 撤回 right after the click, then came back as 未提交 on the next visit with the file still sitting there.
submit_reportreloads and re-checks, re-clicks once if it fell back, and returnsstatus_verified;enginereportssubmitted: trueonly when that check passed.Experiment status comes from the detail page. The list badge reported
submitted: falsefor every experiment, including ones the platform itself showed as 已提交.list_experiments(verify=True)re-checks each row against the detail page and reportsstatus,submitted_filesandsubmitted_source.Submitted files expose the download button. The platform renders 「下载」 as a
<button>, sosubmitted_linkswas always empty;submitted_download_buttonsnow records it.
Related MCP server: uplus-mcp
What's new in 0.8.2
Four places where the 0.8.0 compliance work still got stuck on the real platform. Suite is 321 passed, 1 skipped.
Phone-number accounts can sign in automatically. The school login page opens on the 学号/工号 tab, whose account box asks for a student/staff number and requires picking a school — a phone number cannot sign in there.
auto_loginnow switches to the 密码登录 tab first (it detects the tab viainput[placeholder*='手机']) and skips the school step once there; login pages without that tab keep the old single-form path.Drawing rows are no longer read as placeholders.
is_placeholder_texttreated a whole row of dots or hashes (a grid map, a state-space diagram) as an unfilled slot and refused the report. Rows made only of. # * · @ +are now treated as content;____,---,(此处填写…),待填写andTODOare still placeholders.A repeated sub-heading no longer truncates a section. A body line 「一、算法伪代码」 resolves to the 实验实现 alias; a repeat used to count as a new section boundary, cutting the earlier section's body off and reporting it as empty.
_missing_sectionsnow takes only the first sighting of each section as its heading.Navigation timeouts retry. Some course
ExperimentPagescreens do not render within 30 seconds, so the whole course appeared to have no experiments.list_experiment_idsandopen_detailnow go through_open_page(45 s timeout, one retry) and only fail after both attempts;BrowserSession.openacceptstimeout_ms.Tests:
tests/test_optimizations.pyadds 11 cases.
What's new in 0.8.0
The complete experiment pipeline, plus a numbered pre-submission compliance checklist that blocks hard failures before upload and fixes the "phantom submission" where an upload alone was reported as submitted. Suite is 310 passed.
Compliance checklist and the phantom-submission fix
The pipeline could tell whether a document had content; it could not tell whether the teacher would accept it. This part adds a numbered 19-item compliance checklist that blocks the hard failures before upload, and fixes the "phantom submission" where an upload alone was reported as submitted.
New
compliance.py— findings come in three levels:block(refuse to submit),warn(docked marks, still allowed),manual(cannot be judged automatically, listed asskippedinstead of silently passing). Items cover the teacher-template cover fields (school, major, class, student id, name, teacher), 实验时间/学时, the 实验名称 field, section structure vs the template, handbook requirement coverage, screenshots when the handbook demands them, environment claims without evidence, reproducibility (commands/seeds/paths/parameters), AI-sounding meta talk, duplicated sections, table and long-line layout, and hash-named files.Stricter gate —
verify_reportgainsstrict_compliance(defaultTrue): any blocking item refuses the upload with the item number and the missing detail.answer_experiment/uplus_answer_experimentgainforceto downgrade the checklist to warnings.No silent re-submission —
answer_experimentreads 「已提交」 and then only generates, telling the caller to withdraw first.Phantom submission fixed —
upload_reportclicks a real 「提交」button(the old code clicked anydivcarrying that text, which did nothing), accepts a confirmation dialog, then polls the page until 「已提交」+「撤回」 appear and raises otherwise.submit_reportnow requires the 「已提交」 badge and either 「撤回」 or the file in the submitted list — an upload's "转换成功" line is no longer success.Template search covers three sources — 实验附件 → 实验手册 (new
manual_linkscapture) → 资料 (recursive), preferring a genuinely downloadable file and reporting itssource.Tests — new
tests/test_compliance.py(11 cases) plus strict/non-strict gate cases; suite is 310 passed.
Experiment pipeline
Read the experiment's requirements, search all sources (实验附件 → 实验手册 → 资料, recursively) for the report template, download the materials, fill the template, and only submit after the inspection and compliance checks pass.
New
materials.py— the 资料 section has no fixed route contract, so it is discovered rather than hard-coded: open the course home, find the 「资料 / 资源 / 素材 / 文件」 entry in the sidebar, list the current folder, descend into folders (deduplicated by(name, href), depth-capped), and match 「实验报告模板 / 报告模板 / 实验N」.Binary download (previously the tool could only upload) —
BrowserSession.fetch_bytestries an in-pagefetchwithx-access-token(same-origin), then falls back tocontext.request.get(shared cookies, not bound by CORS, reaches cross-origin OSS links); an entry with no href falls back to anexpect_downloadclick. Every write is confined toallowed_io_paths, underreports/experiment_materials/.Template filling —
report_generator.fill_templateopens the real downloaded .docx template and writes into the empty paragraph or table cell following each section heading, replacing「(此处填写…)」「待填写」「TODO」 placeholders.describe_templatereports the structure first;derive_sectionsextracts the handbook's own section text verbatim. With no template it falls back to the built-in format and runs the same filler.Four new MCP tools —
uplus_download_experiment_materials,uplus_inspect_experiment,uplus_answer_experiment,uplus_audit_experiment.The homework-style inspection gate —
verify_reportrefuses a report before upload when it is too small / has too little body text (blank), still carries a placeholder, or talks about a different experiment.answer_experimentalso requires every model-written section; a missing one refuses generation and submission. After submitting, the page is re-read and success is only reported when the submission registered. The olderuplus_submit_experiment_reportnow passes the same gate.Patrol integration — unsubmitted experiments produce
experiment_briefs(the sections to write; nothing is downloaded or submitted automatically), submitted experiments get a read-only audit, and the Markdown report gains an "experiment completeness" table.A blocking gap fixed —
Experimentand the experiment-list scraper did not carryexp_id/stu_exp_id, souplus_list_experimentscould not lead to any follow-up tool. Both ids are returned now.Student name / number — set
student_name/student_idin the gitignoredconfig/courses.json; a tool call may override them. They are written only into the local report .docx (gitignored), never into the repo or the Markdown patrol report.Tests — 42 new cases in
tests/test_lab.py.
What's new in 0.7.8
Patrol now checks already submitted homework by default, detects partial multi-select answers, and can withdraw/complete/resubmit a homework through a guarded repair action. Suite is 250 passed.
Submitted homework is audited on every patrol —
uplus_patrol'sauditnow defaults totrue; the CLI audits unless--no-auditis given. The completeness table gains separate "missing" and "partial multi-select" columns, plus a count of multi-selects that could not be judged.Partial multi-select answers are detected — the audit compares
userAnswerwith the platform's standard answer (answer) as sets. A proper subset (standardABC, submittedA) ispartialand reports the omitted letters (BC); letters outside the standard answer arewrong. Option order does not matter (ABequalsBA).Pending submissions get a second source of truth — the platform only exposes
answerafter grading; while pending, the student detail has no standard answer and the page only shows "我的答案". A local answer journal (reports/answer_journal.json, gitignored) records every answer this tool submits, so a pending homework can still be checked. With neither source the question is reported asunjudged, never silently treated as complete.New
uplus_repair_homework— performs "withdraw → fill gaps → resubmit" as one guarded action. Only a homework whose page shows撤回作业(submitted, pending grading) can be withdrawn; a graded one is refused. Withdrawal happens only after every known gap has an answer (the caller'sanswersfirst, the local journal second); otherwise nothing is withdrawn and the submission stays untouched. Existing answers are preserved and re-filled, so a withdrawal that clears the draft can still be restored. The tool re-audits after resubmitting.A repair answer is validated before withdrawal — if the new answer still misses letters of the known standard answer, the tool refuses to withdraw and says which letters are missing, so a repair cannot reintroduce 漏选.
Optional re-verification —
verify_unjudged=Truere-answers every multi-select whose completeness could not be checked while pending, then resubmits. Without it, only known missing/partial questions are repaired.Code-block options are readable and clickable — options such as
A、<property>/C、<constructor-arg>come from<p><code>fragments and are parsed as plain text; on the page they sit inside alabel.el-radiowhose input value is the letter, so the existing locator finds them uniquely. Regression tests pin both behaviours.Patrol returns
repair_briefs— each affected homework lists the questions, current answer, standard/journal answer and whether the model must answer. The CLI writes the list next to the report as*.repair.json.24 new tests — partial detection, the journal, unjudged pending multi-selects, guarded withdraw/resubmit, rejection of incomplete repair answers, code-block option parsing and page locators. Total 250 passed.
What's new in 0.7.7
A hardening pass over 0.7.6 plus figure-question support: three real defects found while re-reading the code and one new capability, without changing any documented behaviour. Suite is 226 passed.
Figure questions can finally be seen — new tool
uplus_capture_question_image(task_id, course_id, order=…). The platform stores a diagram as an<img>inside the stem's rich text;strip_htmldropped it, so a judge question like 「以下模型是非对称密码体制中的两种模型」 reached the model as text with no picture and could only be guessed. The question detail now exposesimages, the brief carries afigure_notenaming the tool, and the tool navigates to the question by stem (same rule as filling) and returns that question's block as a real MCP image content block plus the saved PNG path. It fills and submits nothing.A list page whose stem cannot be scoped no longer reads other questions' checkboxes — 0.7.6 introduced page-state verification for multi-selects. On a list-view page the scope comes from the stem; when the stem could not be narrowed the code fell back to the whole page, which holds every question's boxes. Reading that mixed this question's state with its neighbours', and the reconciliation would then uncheck someone else's option. Such a page now reports "unverifiable" and the fill falls back to the API-side delta instead. (Single-question views are unaffected: there is nothing else on the page.)
userAnswercan be a non-string, and no longer crashes the answer path — the value comes from a JSON payload, so it can arrive as a number, a list or a bool.utils.normalize_letterscalled.upper()on it directly, raisingAttributeErrorin the middle of filling a question.The experiment-name fallback no longer labels a requirement line as the title — a line like
实验要求:掌握进程同步的基本方法or提交物:进程同步实验报告used to be reported as the experiment's name. The fallback now requires a short line without a:/:separator, so only a real title line matches.29 new tests — 18 in
tests/test_figure_questions.pycover image detection, the brief's figure hint, question-container screenshots, path confinement and the text+image tool contract; 11 intests/test_answer_fixes.pycover the unscoped-page refusal, the non-stringuserAnswerpath and the experiment-name fallback.
What's new in 0.7.6
A correctness release for answering: partial multi-selects are no longer left partial, and a question can no longer be answered on the wrong page position. Every fix below is covered by a regression test; the suite is 195 passed.
Multi-select is reconciled with the page, not the API — the old code clicked
target − userAnswer. On a page where the student had already ticked an option the API did not know about, that click unchecked it, and a fresh page whose boxes were already set could end up missing exactly the letters it meant to add. Filling now reads the real checked boxes, ticks only the missing letters, unticks only the extras, re-reads the page, and raises if the target still cannot be reached — so the submit gate refuses an incomplete multi-select instead of handing it in silently.An already-answered multi-select is re-checked — the loop used to skip every question the platform marked answered, even when the model's answer had more letters (the "漏选" case). It is now re-filled whenever the model answer differs from the recorded one; a recorded multi-select with no model answer is counted as "cannot verify" and blocks auto-submit instead of passing silently.
Navigation is verified before typing — clicking an answer-card number can miss. The page stem is re-read after the click and compared with the expected question; on a mismatch the question is skipped (and reported), never filled into whatever question happens to be open. This also fixes a real bug where a question whose page position was 1 returned early without clicking, after the stem walk had left the page on the last question — its answer landed on the wrong question.
Duplicate stems no longer collide — two questions with identical rich text used to overwrite each other in the position map, so one of them could never be reached. Duplicates get a positional suffix and each position is consumed once.
List-view pages are scoped per question — when every question renders at once, option / judge / blank locators are now confined to the container of the question being filled (located by its stem) instead of always hitting the first question on the page. Option labels use
starts-with(…, "A、")so an option whose content mentions "A、" cannot be picked by mistake."Answered" now means a real
userAnswer— the platform creates an answer row (hwAnswerId) and flipsisAnswerwhen a question is merely opened. Counting those as answered made the completeness audit report blank questions as done (the "漏题" false negative) and kept them out of answer briefs. The audit, the patrol brief and the fill loop now require a non-emptyuserAnswer.Answer parsing ignores prose — a model answer like
"AC because A and C are correct"used to contribute every Latin letter in the explanation as an option. Only the leading choice group is read, intersected with the question's actual options; empty choice answers are rejected instead of clicking nothing.Fill-blank input is read back — a rich text editor that ignores
fillis now reported as an error rather than looking like success.
What's new in 0.7.5
Answering is now keyed to the question text instead of the page position, and option clicks survive both page layouts. Two bugs surfaced on a real quiz.
Page order is no longer trusted — on single-question pages (the ones with a
答题卡grid and上一题/下一题) the page order and the APIorderdiffer, so clicking by API order answered the wrong question. The fill loop now maps every page position to its stem first and navigates by that, and refuses to answer a question whose stem cannot be found instead of risking a wrong click.Options without
A、can be clicked — some quizzes render the letter in its own span (A+开闭原则) rather than as one label text. The text locator timed out and those questions could never be answered; it now falls back tolabel:has(input[value="A"])when that letter is unique on the page.Nine tests cover stem normalization, the page-order mismatch, the longest-prefix tie-break and the unknown-stem case. Suite is 179 (178 passed, 1 skipped).
What's new in 0.7.4
A completeness audit for already submitted homework: you can now tell whether a handed-in homework left objective questions blank without withdrawing it, and only a real gap leads to "withdraw → fill → resubmit". The audit itself is read-only against the platform.
New tool
uplus_audit_homework(task_id, course_id)— every question is read from the student-side detail, and a question counts as answered whenuserAnswerorhwAnswerIdis non-empty (the same rule asmodels._is_answered()). 0.7.6 corrected this rule: only a non-emptyuserAnswercounts — see "What's new in 0.7.6". Nothing is withdrawn, filled or submitted, so pending and already-graded homework can be audited safely. Short-answer, programming and attachment items are counted separately and never make a homework "incomplete".Patrol can carry the audit —
uplus_patrol(audit=True)anduplus-patrol --auditcheck every submitted homework while patrolling. Homes with gaps land in the report and in the takeover list, labelled "can withdraw and fill" or "graded, cannot withdraw", with the question numbers truncated after ten.New report section "提交完整性核查" — course, homework, number of blank questions, their question numbers, and whether the homework is still withdrawable, in one table.
The version number is finally consistent —
__version__still said 0.7.0 because 0.7.1–0.7.3 only bumpedpyproject.toml; everything is 0.7.4 now,maven-package/pom.xmlincluded.A time-bomb test is fixed —
test_course_dates_from_the_study_feed_are_numerichard-coded a2026-11-05deadline, sois_expired()returnedTrueonce that date passed and the test could only fail. It verifies date parsing, not the clock, so the deadline is now built as "now + 365 days".withdrawablefollows the page, not the API — the homework API still reports a handed-in homework as "not submitted", so the audit reads the answer page's real button state before deciding whether it can be withdrawn, and only falls back to the API status (withpage_state_noteexplaining it) when that read fails. Skipping this would drop exactly the "submitted but incomplete" homework the audit exists for.9 new tests (
tests/test_audit.py) cover gap detection, subjective items excluded, thehwAnswerIdpath, report rendering, the graded case, the page state overriding the API and the fallback when the page read fails. Total: 174.
What's new in 0.7.3
The Maven publish is now self-diagnosing, and its credentials are written explicitly instead of relying on a generated template.
The
settings.xmlis written by the workflow — the<server>block that GitHub Packages reads the token from is now created with a known content, so a credential that never lands in the file is no longer possible.The registry is probed before the deploy — a read-only request for the POM reports whether the credentials were accepted (401), whether the version is absent (404) or already published (200), so a failed publish says which of the three it was.
The Maven error is readable without opening the raw log — the failing lines are mirrored as error annotations on the run, next to the log artifact.
What's new in 0.7.2
The publish pipeline now works end to end. 0.7.1 created the Release but could not register the Maven package, because the POM attached the wheel and the sdist to itself and the GitHub Packages Maven registry rejects artifact extensions it does not know - the deploy failed with 400 and the Packages panel stayed empty, which is the one thing that entry exists for.
The Maven package publishes only its POM — the wheel and the sdist are no longer attached to it, so the deploy uploads the one file the registry accepts. The installable distributions remain the Release assets, which is where pip users get them anyway.
A publish failure now explains itself — the Maven output is captured into a
mvn-deploy-logartifact and the tail of it is written to the run summary, so the next failure says why instead of only saying that it happened.
What's new in 0.7.1
A code-review release: an audit of the 0.7.0 code found deadline arithmetic that depended on the machine's timezone, a hostname check that matched a substring instead of an origin, and a release pipeline whose Maven publish could never authenticate. All are fixed here; no tool contract changed.
Deadlines are read as Beijing time — the experiment and homework cards parsed the page's wall clock with a naive
datetime, so.timestamp()applied the machine's UTC offset. On a machine that is not set to UTC+8 every deadline in the patrol report drifted by that offset, and the "deadline approaching" warning fired at the wrong time. Parsing is pinned toAsia/Shanghainow (utils.parse_cn_datetime).A non-numeric timestamp no longer aborts the patrol — the course feed can answer with a date string (
endDate/startDate); comparing it with an integer raisedTypeErrorand killed the whole run. Values are coerced (utils.to_epoch_ms) and degrade to "unknown".The API read only runs on the platform origin — the origin check was a substring test (
host not in page.url), so a page onwww.eduplus.net.evil.examplepassed it. The parsed host is compared now.Every experiment is named — the detail page's title was matched only for
实验一/实验二(with an operator-precedence bug that also matched "实验一" anywhere in a line), so实验三…实验九came back nameless.One config for all tools — the report tools loaded their own config while the engine used another, so the allowed-IO allow-list could disagree between the two. The config is parsed once and shared, and report generation moved onto the worker thread instead of blocking the event loop.
The generated report uses 宋体 —
font.nameonly writes the Latin face; Word reads Chinese glyphs fromw:eastAsia, which stayed on the theme default.The release pipeline authenticates and fails loudly —
mvn deployhad nosettings.xml, so the Maven publish could only ever return 401, andcontinue-on-errorhid it. The publish now gets its credentials fromsetup-java, the test suite runs before the build, the git tag is checked against the package versions, and a publish failure ends the run red with a named error while the GitHub Release is still created.An installed wheel no longer writes into the Python library —
PROJECT_ROOTwas derived fromparents[2], which in a wheel install is the directory holdingsite-packages: reports landed there (unwritable on a system-wide install) and the allow-list refused the user's own project. Relative paths now resolve against the working directory, orUPLUS_HOME.The example config ships inside the package —
uplus_mcp/courses.example.jsonis packaged with the wheel, so a wheel install can still offer it.Personal coursework is ignored — the generated reports carry the student's name and student number;
*.doc,*.docx,*实验*.candgen_exp*.pyare now ignored, so a GitHub Desktop "Commit all" cannot publish them.42 new regression tests (
tests/test_code_review_fixes.py). Suite total: 165 tests.
What's new in 0.7.0
A security-hardening release: an audit of the 0.6.0 code found that a page the
model had navigated to could turn a navigation step into a local-file read
(file:///…), and that several file tools accepted any path on disk. Both are
closed here. Behaviour of the documented flows is unchanged.
Navigation is restricted to
http/https— the batch runner (browse_act_batchwithop: "navigate") used to pass a URL straight to the browser, so afile:///C:/…step could open a local file andextractits contents into the model context; combined withbrowse_uploadthis was a read-and-exfiltrate path.navigateanduplus/browse_opennow share one scheme allow-list (utils.safe_navigation_url) that refusesfile:,ftp:,data:,javascript:andblob:with an explanatory error, and internal relative routes still resolve against the platform origin.File tools are confined to allowed directories — report output, screenshots, homework attachments and experiment uploads now resolve their path against
allowed_io_paths(config key, orUPLUS_ALLOWED_PATHS) and refuse anything outside it...,~and symlinks are collapsed before the check, soreports/../../.ssh/id_rsaand~/.ssh/id_rsaare both rejected. The default roots are the report folder and the system temp directory, which keeps "generate a report, then submit it" working with no configuration.python-docxis now a declared dependency —uplus_generate_experiment_reportimported it lazily, so the headline feature of 0.6.0 failed withModuleNotFoundErroron any environment that did not already have it.32 new regression tests (
tests/test_security_hardening.py) cover the scheme allow-list, path traversal / symlink / home-expansion escapes, the allowed-path config plumbing, report generation and secret redaction. Suite total: 123 tests.CI actions pinned to commit SHAs —
checkout,setup-python,setup-javaandaction-gh-releasenow pin the exact commit they were reviewed at instead of a movable major-version tag.Smaller fixes: API error bodies are passed through
redact_secretsbefore they reach the model context; the school selector no longer falls back to clicking the first dropdown item when nothing matched (it now fails over to manual sign-in rather than trying the wrong school); theuplus_logindocstring documents the 30-second auto-mode wait cap.
What's new in 0.6.0
Experiment automation: three new MCP tools let the model read an experiment's requirements, generate a standard experiment report
.docx, and upload it for submission.uplus_read_experiment_detail— opens the experiment detail page, switches tabs, and returns name, status, environment, material, deadline, already-submitted files and the manual text.uplus_generate_experiment_report— builds a structured.docx(title, purpose, content, steps, implementation, analysis, summary, requirements) from a few parameters; includes the algorithm-course template.uplus_submit_experiment_report— uploads the generated file through the platform's file input and confirms the submission state.
Two new modules:
experiment.py(list / read detail / upload) andreport_generator.py(python-docx based report builder).18 regression tests guard the new modules and keep the total suite green at 91 tests.
What's new in 0.5.2
Five audited defects closed (3 high, 2 medium):
Profile directory copy now refuses when source and destination overlap, or when the target lacks the
Local Statemarker — prevents accidental recursive deletion of user data.fill(),snapshot, and batchextractall mask password fields as••••— no more password echo in single-step fill or page snapshots.Submit gate now counts previously-answered objectives in the total, and refuses to submit when the question list is empty (no more
0 == 0pass).patrol(auto_answer=True, submit=True)is now wired through the rule hook with a full-coverage gate — actually submits when all objective questions have rule answers.Unknown or expired course ID now raises an error instead of silently widening the query to all courses.
18 regression tests in
tests/test_fixes.pyguard all five fixes.CI publish fix:
pom.xmlartifact filenames now use${project.version}instead of hard-coded0.5.0, and the workflow clearsmaven-package/artifactsbefore copy to prevent stale files from previous releases.
What's new in 0.5.0
Cross-platform, machine-agnostic install: the launcher now probes installed Microsoft Edge or Google Chrome on Windows, macOS and Linux, with a PATH fallback; no Windows-only executable path is hard-coded. The CDP port, browser engine and dedicated profile directory are configurable (
browser,cdp_port,profile_dir,auto_launch_browser) and overridable through environment variables (UPLUS_BROWSER,UPLUS_CDP_PORT,UPLUS_PROFILE_DIR).Generic browser wording: the session attaches to whichever desktop browser the user has installed. The original tool name
browse_launch_edgeis kept for compatibility; it launches Edge or Chrome according to the config.rename.mdonboarding playbook: every AI agent reads this before guiding a new user through environment check, install, client registration, two-mode sign-in, patrol, objective-question answering and human-takeover handoff.
0.4.2 — two-mode sign-in and batched page actions
Two-mode sign-in (
uplus_login): the model first asks the user whether to sign in manually (open the portal and wait for the user to finish in the browser window) or automatically (ask for account, password and school name, fill the school selector, account and password, submit and verify the session). Auto-mode credentials live only for that call and are never persisted to config, reports or logs, and never echoed back; missing fields, an unmatched school selector, captchas, SMS codes or wrong-password prompts fall back to manual takeover.Batched page actions (
browse_act_batch): run a short serial batch of clicks, fills, presses, scrolls, waits, extracts and navigation; the batch stops on the first failure or navigation and returns a completed / remaining / failure / navigated receipt. Password-field values are never extracted back.Attachment question type (
qsnType=7) and a three-state experiment status (submitted / outstanding / unknown) that hands unknown cards back for manual review; expired courses are skipped during patrol by default.
0.4.0 — merged browse toolset and stability fixes
Merged browse toolset: 17 single-step
browse_*tools let the model drive any web page directly (open, snapshot, click, fill, type, press, scroll, screenshot, eval JS, tabs) on the same attached browser session — the fallback when the platform's REST contract changes or a step has no API.Fixed the asyncio crash: FastMCP calls sync tools on the event-loop thread, where Playwright's sync API refuses to run. All browser work now runs on one dedicated worker thread (
worker.py); tools are async and await it.Fixed 401 on every read API: U+ requires an
x-access-tokenheader (fromlocalStorage.AccessToken) on each API call, not just cookies.Fixed the debug port that never listens: Edge/Chromium 136+ ignores
--remote-debugging-porton the default user-data directory.launcher.pycopies the profile to a dedicated directory once (login survives) and starts the browser there with the port;browse_launch_edgedoes it in one call.
An MCP server that patrols the 青软 U+ learning platform: it lists courses, homework and experiments, reads objective questions into a structured brief, lets the connected MCP client model answer, fills the answer page, verifies selections and submits. Subjective questions, programming work, experiment reports and file attachments are explicitly handed back to the human.
Academic integrity notice — This tool is a personal study and reminder helper. Use it to review questions, track deadlines and organize your own work. Experiment reports, group deliverables, programming assignments and open-ended answers must be completed by yourself. Follow your school's academic honesty rules and course instructor instructions. Do not use this tool in exams, closed-book tests or any assessment that prohibits assistance.
Features
The session attaches to the user's own installed Edge or Chrome through CDP; the server stores no passwords, cookies or login snapshots in the repository.
Read-only REST calls reuse the in-page session; page writes follow the real human path (option click, confirmation dialog, post-submit button verification).
Objective questions (single choice, multiple choice, true/false, fill-in) can be filled and submitted after the client model returns a normalized answer map.
Patrol report in Markdown: submitted / pending / outstanding homework, experiments, and a takeover list for manual work.
Completeness audit:
uplus_audit_homeworkreports, read-only, which objective questions of an already submitted homework are still blank and which multi-selects were submitted with only part of the correct options. Patrol runs this audit by default;audit=Falseskips it. Known gaps are repaired throughuplus_repair_homework(withdraw → complete → resubmit), which never withdraws before every gap has an answer.Works with any MCP-compatible client: Claude Desktop, Cursor, VS Code MCP, Doubao agent, DSH and others.
Unattended CLI for nightly scheduled patrol; it never answers or submits on its own.
Architecture
MCP client ──stdio──▶ server.py (FastMCP tools)
│
engine.py (orchestration)
┌───────────────┼────────────────┐
platform.py operator.py report/solver
read-only REST page UI writes reports + normalization
└───────────────┼────────────────┘
browser.py (Playwright session)See docs/architecture.md for module responsibilities,
docs/api-mapping.md for the captured U+ endpoints and
status rules, and docs/adapter-guide.md for adding
another platform.
Quick start
1. Install
From a GitHub Release wheel (recommended, no clone needed):
Open the Releases page and download the
uplus_mcp-<version>-py3-none-any.whlasset attached to the latest release.Install that downloaded wheel:
pip install <download-path>/uplus_mcp-0.5.0-py3-none-any.whlThis provides the uplus-mcp and uplus-patrol console scripts. Python 3.10+
is required; the server attaches to an installed Edge or Chrome over CDP, so no
bundled Chromium download is required for the normal flow.
From source (development or latest unreleased code):
Replace
<install-dir>with the absolute path of the folder containingpyproject.toml(this repository root).
Windows PowerShell:
cd <install-dir>
python -m venv .venv
.venv\Scripts\python.exe -m pip install -e .macOS / Linux:
cd <install-dir>
python3 -m venv .venv
.venv/bin/python -m pip install -e .2. Configure personal courses (gitignored, optional)
The example config ships inside the package (uplus_mcp/courses.example.json).
Copy it to config/courses.json in your project folder, then fill in your
actual course ids.
Windows PowerShell (source checkout):
Copy-Item src\uplus_mcp\courses.example.json config\courses.jsonmacOS / Linux (source checkout):
cp src/uplus_mcp/courses.example.json config/courses.jsonInstalled from a wheel? The example sits next to the installed package:
python -c "import pathlib,uplus_mcp;print(pathlib.Path(uplus_mcp.__file__).parent/'courses.example.json')"Edit config/courses.json with your actual courseId values and local paths.
Leaving courses empty makes the server fetch the live course list after sign-in.
3. Sign in
Ask the MCP client to run uplus_login:
mode="manual": the portal opens in the attached browser window; finish signing in yourself, and the tool waits until the session token appears.mode="auto": the model first asks for your account, password and school name, fills the school selector, account and password fields, submits and verifies the session. Credentials are used only for that call and are never saved or echoed back. If the form cannot be found, the school selector cannot be matched, or a captcha / SMS code / wrong-password prompt appears, fall back to manual mode.
If the debug port is not listening yet, call browse_launch_edge once; it copies
the browser profile to a dedicated directory and starts Edge or Chrome with the
port.
4. Register the server in your MCP client
See docs/mcp-clients.md for Claude Desktop, Cursor and VS
Code examples.
Installed from the Release wheel (or editable source): register the console script directly:
{
"mcpServers": {
"uplus": {
"command": "uplus-mcp",
"env": { "UPLUS_CONFIG": "config/courses.json" }
}
}
}Installed from source (Windows example; macOS/Linux use
<install-dir>/.venv/bin/python):
{
"mcpServers": {
"uplus": {
"command": "<install-dir>\\.venv\\Scripts\\python.exe",
"args": ["-m", "uplus_mcp.server"],
"cwd": "<install-dir>",
"env": { "UPLUS_CONFIG": "config/courses.json" }
}
}
}Tools
U+ workflow
Tool | Description |
| Sign in by |
| Verify whether the attached browser session is signed in |
| List courses under the signed-in account |
| List homework status; open answer pages to verify button truth on demand |
| List experiments with |
| Download the experiment's attachments plus the 资料-section report template |
| Return the experiment brief: requirements, template, |
| Fill the template, run the inspection gate, upload and submit; re-reads the page to confirm |
| Read-only audit of a submitted experiment: blank report, leftover placeholders, wrong experiment |
| Build a standard report .docx from scratch (fallback when no template exists) |
| Upload and submit a report; |
| Return status and a structured question brief for the client model |
| Screenshot one question block (diagram included) and return the image to the model |
| Fill objective questions and optionally submit |
| Withdraw a submitted homework, complete missing/partial answers, resubmit and re-audit |
| Attach a local file to a homework that requires upload |
| Full patrol (submitted-homework audit on by default), Markdown report, answer/repair briefs and takeover list |
| Release the browser session held by this process |
Generic browser (browse_*)
Single-step tools: browse_launch_edge (kept for compatibility; launches Edge or
Chrome per config), browse_open, browse_snapshot, browse_get_text,
browse_click, browse_fill, browse_type, browse_press, browse_scroll,
browse_select_option, browse_upload, browse_screenshot, browse_eval_js,
browse_wait_for, browse_tabs, browse_switch_tab, browse_back.
browse_act_batch runs a short serial batch of those actions: click, fill,
press, hover, scroll, wait, extract, navigate, back. The batch stops on the first
failure or navigation and returns a completed / remaining / failure / navigated
receipt; observe="summary" skips the follow-up snapshot. Password fields are
never extracted back.
Nightly patrol (unattended)
Windows:
.venv\Scripts\python.exe -m uplus_mcp.daily_patrolmacOS / Linux:
.venv/bin/python -m uplus_mcp.daily_patrolThe CLI writes reports/patrol_YYYYMMDD_HHMM.md and a .brief.json for
outstanding objective questions. Exit code 2 means the login session expired;
exit code 1 means a runtime failure. Register this command in Windows Task
Scheduler, macOS launchd, or Linux cron (e.g. daily 21:30).
The CLI never submits homework. Answer and submission happen through an MCP session after the model reviews the brief.
GitHub Packages
A GitHub Actions workflow publishes a metadata-only Apache Maven package to this
repository's Packages registry on every v* tag push (and can be run manually
from the Actions tab with an explicit tag). The workflow uses the built-in
GITHUB_TOKEN, so no personal access token is required to publish.
The workflow runs the test suite before it builds, checks that the git tag
matches the version in pyproject.toml and maven-package/pom.xml, creates
the GitHub Release with the wheel and sdist attached, and only then publishes
the Maven package. A Maven failure therefore never costs the release, but it
does end the run red with a named error instead of passing silently.
Release notes come from .github/release-notes/<tag>.md when that file exists
(for example v0.8.0.md); otherwise GitHub generates them from the commits, so
a missing notes file never fails the run.
maven-package/
pom.xml metadata-only Maven POM (com.github.jiangjunw15-web:uplus-mcp)
artifacts/ wheel and sdist attached as supplementary files (gitignored)
.github/workflows/publish-packages.yml build distributions and run `mvn deploy`Important: the Maven entry only registers the package in the repository's
Packages panel. It is not a Python distribution and cannot be installed with
pip. Python users install from the Release wheel or the source checkout:
Console script after a wheel/editable install:
uplus-mcpNightly patrol CLI:
uplus-patrol(orpython -m uplus_mcp.daily_patrol)
Configuration reference
config/courses.json:
Field | Default | Meaning |
|
| Platform root |
|
| Page navigation timeout |
|
| UI action timeout |
|
| Highlight deadlines inside this window |
|
| Markdown report output folder |
|
| Copy the profile and launch a browser with the CDP port when no port listens; legacy |
|
|
|
|
| Preferred CDP port; 9222 is the fallback; env |
| user-home dedicated directory | Dedicated browser profile directory; env |
|
| Skip expired courses during patrol; set |
| empty |
|
Development
pip install -e ".[dev]"
pytest165 unit tests cover model parsing, config loading, answer normalization, page state rules, experiment classification, the two-mode login flow, the batch action receipt, cross-platform browser detection, config compatibility and the security hardening of 0.7.0 / 0.7.1.
Browser and platform interactions are exercised against a real session in read-only patrol mode; write actions require the authorized account and an active course deadline.
Repository layout
src/uplus_mcp/
browser.py CDP-attached Playwright session + in-page fetch
browse.py generic single-step and batched page actions
platform.py read-only REST client
operator.py page UI operations
engine.py shared orchestration
models.py domain objects and enums
config.py configuration loader
solver.py brief generation + answer normalization
report.py patrol report aggregation and Markdown render
utils.py HTML cleaning, time and answer normalization helpers
worker.py dedicated thread that runs all Playwright sync calls
launcher.py locate / launch Edge or Chrome with the debug port
server.py FastMCP tools
daily_patrol.py unattended CLI
scripts/smoke_mcp.py stdio end-to-end smoke check
docs/ architecture, API mapping, client config, adapter guide
config/ personal config example (real file gitignored)
reports/ generated patrol reports (gitignored)
tests/ unit testsSafety and privacy
Keep
config/courses.jsonandreports/local; they are listed in.gitignore.Do not commit student IDs, names, phone numbers, email addresses, cookies or tokens.
The server never persists your password;
uplus_loginauto-mode uses credentials only for the current call and never writes them to config, reports or logs or echoes them back in tool results.
License
MIT, see LICENSE.
Available Tools
38 toolsbrowse_act_batchA
Run one short batch of page actions; stop on failure or navigation.
Each step supports: click (selector/text/nth), fill
(selector, value, optional press_enter), press (key),
hover, scroll (amount/selector), wait
(selector/text/timeout_ms), extract (selector,
fields: text/value/href, maxRows), navigate (url), back.
Returns completed steps, remaining count, extract rows and a failure or
navigation receipt. observe="summary" skips the follow-up snapshot;
observe="snapshot" reads the body once afterwards. Sensitive or
destructive actions need explicit user authorization; do not repeat a step
whose receipt reports failure or navigation.
Inputs: steps (required), observe.
browse_backB
Navigate back one history entry.
Inputs: no named parameters.
browse_clickC
Click an element by CSS selector or by visible text.
Inputs: nth, text, selector.
browse_eval_jsC
Evaluate a JavaScript expression in the page and return its JSON value.
Inputs: expression (required).
browse_fillC
Replace an input's value, optionally pressing Enter afterwards.
Inputs: value (required), selector (required), press_enter.
browse_get_textA
Read the text content of an element (defaults to the whole body).
Inputs: selector.
browse_launch_edgeA
Launch an installed browser (Edge / Chrome) with a CDP debug port on a dedicated profile copy, then verify the port listens.
The tool name keeps the original browse_launch_edge spelling for
compatibility; it launches whichever engine the config browser field
selects (auto picks the first installed Edge or Chrome). port of
0 means "use the configured CDP port" (default 9333, fallback 9222).
Needed because Chromium 136+ ignores --remote-debugging-port on the
default profile directory. Login cookies survive the copy, so U+ stays
signed in.
Inputs: port, refresh_profile.
browse_openB
Open a URL in the attached browser tab and return its title/status.
Inputs: url (required).
browse_pressB
Press a key or combination, e.g. Enter or Control+A.
Inputs: key (required).
browse_screenshotB
Screenshot the page: returns a path, or base64 when no path is given.
Inputs: path, full_page.
browse_scrollA
Scroll the page by pixels, or scroll a specific element into view.
Inputs: amount, selector.
browse_select_optionC
Choose an option in a <select> by value.
Inputs: value (required), selector (required).
browse_snapshotC
Return a compact snapshot: interactive elements (selector/role/text) + visible text.
Inputs: max_nodes.
browse_switch_tabB
Switch the active tab by index from browse_tabs.
Inputs: index (required).
browse_tabsA
List open tabs with url/title and which one is active.
Inputs: no named parameters. Returns: result
browse_typeC
Type text with a human-like delay into a focused/selected element.
Inputs: text (required), selector.
browse_uploadC
Set files on an input[type=file] element.
Inputs: selector (required), file_path (required).
browse_wait_forC
Wait until a selector exists or text appears.
Inputs: text, selector, timeout_ms.
uplus_answer_experimentA
Fill the experiment report, verify it, and submit it.
sections maps a section name (实验实现 / 实验结果 / 实验总结 …) to its
text — the output of uplus_inspect_experiment's needed_sections.
Server-derived sections from the handbook are merged in automatically; a
supplied value overrides them.
The report is built from the downloaded 资料 template when one exists,
otherwise from the built-in format. Before anything is uploaded the
report must pass the inspection gate: non-empty body, no leftover
placeholders, content that matches this experiment, and the compliance
checklist (teacher-template cover fields, 实验名称 field, screenshots when
the handbook demands them, handbook requirement coverage, AI-sounding
meta talk, repetition, layout). A failed check returns the reasons and
submits nothing; force=True downgrades the checklist to warnings.
With submit=True (default) a passing report is uploaded and submitted,
and the page is re-read until 「已提交」+「撤回」 appear — a mere upload is
never reported as a successful submission. An already-submitted
experiment is not re-submitted. submit=False stops after generating
and verifying. student_name / student_id override the identity in
the personal config.
Inputs: exp_id (required), sections (required), course_id (required), stu_exp_id (required), +5 more.
uplus_answer_homeworkB
Fill objective questions and optionally submit.
answers maps question_id (or question order as a string) to a
normalized answer: one letter, a sorted letter group, true/false, or
blank text. Submission is refused while any question is unanswered or failed
unless force_submit=True.
Inputs: answers (required), task_id (required), course_id (required), submit, +1 more.
uplus_audit_experimentA
Read-only completeness audit for a submitted experiment.
Pulls the submitted report back when the page exposes a download link and checks it for an empty body, leftover placeholders and a report written for a different experiment. When the file cannot be downloaded, the audit says so and only checks the page record — it never reports an unchecked report as clean. It withdraws and submits nothing.
Inputs: exp_id (required), course_id (required), stu_exp_id (required), download.
uplus_audit_homeworkA
Read-only completeness audit for one homework (no withdraw, no submit).
Every question is read from the student-side detail, so an already
submitted homework can be audited safely. A question counts as answered
only when its userAnswer is non-empty; the platform creates an answer
row (hwAnswerId / isAnswer) when a question is merely opened, so
those fields alone prove nothing. The result lists which objective
questions carry no answer (missing) and, when the platform has graded
the homework and exposed its standard answer (answer), which
multi-selects were submitted with only part of the correct options
(partial, with the omitted letters). A multi-select still awaiting
grading has no reference answer and is listed in unjudged instead of
being silently treated as complete. Subjective / programming / attachment
items are counted separately and never make the homework "incomplete".
complete means no missing and no partial multi-select; clean also
requires checked answers to be correct. Fix a gap with
uplus_repair_homework (it withdraws only after every gap has an
answer, then completes and resubmits).
The API status understates (a handed-in homework may read as not submitted),
so withdrawable comes from the page's real button state; set
refresh_page_state=False to skip that page read and trust the API.
Inputs: task_id (required), course_id (required), refresh_page_state.
uplus_capture_question_imageA
Screenshot one question block and return it as an image.
Use for figure questions — a stem whose diagram/picture carries the part
that makes the statement true or false (for example "以下模型是…" with a
crypto diagram). The question text alone cannot be answered reliably, and
the model cannot see an <img> that lives in the platform's rich text.
The tool opens the answer page, navigates to the question by its stem
(same rule as filling), and captures that question's container — not just
the viewport — so the whole figure is readable. It fills and submits
nothing. Identify the question with order (the number shown on the
page) or question_id. The result is the saved PNG path plus the image
itself; answer the question after looking at it and pass the answer to
uplus_answer_homework keyed by question_id.
output_path is optional and confined to the configured IO roots; by
default the PNG goes under the report folder's question_images/.
Set full_page=True when the figure sits outside the question block
(for example a shared table above the questions).
Inputs: task_id (required), course_id (required), order, full_page, +2 more.
uplus_check_loginA
Check whether the attached browser session is signed into U+.
Inputs: no named parameters.
uplus_closeA
Detach from the browser and release the worker session.
Inputs: no named parameters.
uplus_download_experiment_materialsA
Download an experiment's materials from all sources.
Downloads every attachment from the 实验附件 tab, every file link from
the 实验手册 tab, and every matching file from the course 资料 section
(recursing into folders). The best template across all sources is
identified and reported in template / template_source.
Read-only against the platform. Use it after uplus_list_experiments
(which returns exp_id / stu_exp_id) when you want the requirement
files and the template on disk before authoring the report. Files go to
reports/experiment_materials/.
Inputs: exp_id (required), course_id (required), stu_exp_id (required).
uplus_generate_experiment_reportC
Generate a standard experiment report .docx file.
output_path must stay inside the configured allowed directories
(the report folder and the system temp dir by default; extend via
allowed_io_paths in config or UPLUS_ALLOWED_PATHS).
Inputs: title (required), content (required), purpose (required), output_path (required), +2 more.
uplus_inspect_experimentA
Read an experiment and return the authoring brief.
Opens the experiment detail page, reads 实验提交物 / 实验手册 / 实验附件,
and (when find_template) searches all three sources for a
downloadable report template — 实验附件 first, then downloadable files on
the 实验手册 tab, then the course 资料 section (including its folders).
The first source that yields a downloadable template file wins.
The result separates:
auto_sections— 目的 / 内容 / 步骤 / 要求 copied verbatim from the handbook; the server fills these and never rewrites them.needed_sections— 实验实现 / 实验结果 / 实验总结 (plus any template section with no handbook text). Write these yourself from the requirements and attachments, then return{"sections": {"实验实现": "...", ...}}and calluplus_answer_experiment.
template_source reports which source the template came from
(实验附件 / 实验手册 / 资料) or empty when no template was found.
Nothing is filled, uploaded or submitted by this tool.
Inputs: exp_id (required), course_id (required), stu_exp_id (required), find_template.
uplus_inspect_homeworkB
Return homework status plus a structured brief of its questions.
The model reads the brief and returns an answers map to
uplus_answer_homework.
Inputs: task_id (required), course_id (required).
uplus_list_coursesA
List every course attached to the signed-in account.
Inputs: no named parameters. Returns: result
uplus_list_experimentsA
List experiments and their submission state for one course.
Inputs: course_id (required). Returns: result
uplus_list_homeworksA
List homework status for one course, or all courses when omitted.
refresh_page_state=True opens each answer page to read the real submit
button, because the REST status can lag behind the page.
Inputs: course_id, refresh_page_state. Returns: result
uplus_loginA
Sign in to U+ through the attached browser session. Ask the user which flow they prefer BEFORE calling:
mode="manual": open the portal and wait for the user to sign in by themselves in the visible browser window; no account or password is needed.mode="auto": the model first asks the user for their account, password and school name, then fills the sign-in form, submits and verifies the session. Credentials are used only for this call: never persisted to config, reports or logs, and never echoed back. The wait is capped at 30 s so a failed auto fill hands over tomanualquickly. If auto fill cannot find the fields, the school selector cannot be matched, or a captcha / SMS / wrong-password prompt appears, fall back tomanualand hand the window to the user.
Returns logged_in, the chosen mode, current URL and token length.
Inputs: mode, school, password, username, +1 more.
uplus_patrolA
Patrol every configured course and write a Markdown report.
Lists homework and experiments, separates submitted / pending / outstanding /
takeover items, and collects answer briefs for outstanding objective
questions. submit=True only submits homework that received valid answers;
subjective, programming and file items are never auto-submitted.
audit is on by default: every already-submitted homework is re-checked
for unanswered objective questions (漏答) and for multi-selects submitted
with only part of the correct options (漏选). The platform only reveals its
standard answer after grading and hides it while a submission is pending;
a local journal of answers this tool submitted fills that gap. Multi-selects
with neither source are reported as "unjudged", never silently as complete.
The audit itself is read-only. Results also include repair_briefs: when
a gap is found, answer the listed questions and call
uplus_repair_homework to withdraw, complete and resubmit the homework.
Set audit=False only to skip this extra read pass.
Inputs: audit, submit, auto_answer.
uplus_read_experiment_detailB
Read experiment detail: requirements, material, deadline, submitted files.
Inputs: exp_id (required), course_id (required), stu_exp_id (required).
uplus_repair_homeworkA
Withdraw a submitted homework, fill its gaps, and resubmit it.
Use after uplus_patrol (audit is on by default) reports a homework as
missing (漏答) or partial (多选漏选). answers maps
question_id (or question order as a string) to the corrected answer;
the patrol result's repair_briefs lists exactly which questions need
one. Answers already stored in the local journal (because this tool
submitted the homework earlier) are used automatically, so a
journal-covered partial can be repaired without new model answers.
The tool refuses to withdraw until every known gap has an answer. A graded
homework cannot be withdrawn and is reported without changing anything.
Existing answers are preserved and re-filled, so a withdrawal that clears
the draft still leaves enough answers to resubmit. Submission uses the same
gate as uplus_answer_homework; subjective items never block the repair.
verify_unjudged=True additionally re-answers multi-selects whose
completeness could not be checked while the homework was pending grading.
Inputs: task_id (required), course_id (required), submit, answers, +1 more.
uplus_submit_experiment_reportB
Upload and submit an experiment report file.
file_path must stay inside the configured allowed directories (see
uplus_generate_experiment_report). A .docx report first passes the
same inspection the experiment pipeline uses — non-empty body, no leftover
placeholders, topic matching the experiment — and is refused when it fails,
so a blank or wrong report is never uploaded. After submitting, the page
is re-read and success is only reported when the submission registered.
Inputs: exp_id (required), course_id (required), file_path (required), stu_exp_id (required).
uplus_upload_attachmentC
Attach a local file (PPT/PDF/ZIP) to a homework that requires an upload.
Inputs: task_id (required), course_id (required), file_path (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Most U+ domain tools have distinct intents, but several experiment tools overlap heavily: uplus_read_experiment_detail, uplus_inspect_experiment, uplus_download_experiment_materials, and uplus_audit_experiment all read related experiment data. Similarly, uplus_generate_experiment_report, uplus_answer_experiment, and uplus_submit_experiment_report can be confused, and uplus_inspect_homework/audit_homework/answer_homework/repair_homework form a dense cluster. The detailed descriptions mitigate this, but boundaries are not always obvious at a glance.
Tool names use two clear, consistent namespaces: uplus_* for domain operations and browse_* for browser primitives, all in snake_case with predictable verb_noun forms. Minor deviations exist, such as the legacy browse_launch_edge spelling and uplus_close as a bare verb, but overall the pattern is easy to follow.
At 38 tools, the surface is heavy: 20 domain-specific U+ operations plus 18 generic browser primitives. While some browser tools are useful fallbacks, the generic low-level operations (click, fill, type, press, scroll, eval, snapshot, batch) add substantial weight beyond the core course/homework/experiment workflow.
The domain surface covers a full lifecycle: login, course listing, homework inspection/answering/auditing/repairing/submitting, experiment inspection/material download/report generation/answering/submission/auditing, plus attachment upload and image capture. Browser primitives provide fallback navigation and interaction. Minor gaps remain, such as a dedicated browser navigation tool outside batch/open, but agents can work around them.
Maintenance
Related MCP Connectors
Automate any website: discover, run and create browser scripts that work behind logins.
I do everything related to Browser Automation & Management
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Related MCP Servers
- FlicenseBqualityCmaintenanceAutomates login to Tmall/Taobao seller backends and enables browser automation such as navigation, content retrieval, clicking, typing, and screenshots.8102-
- AlicenseAqualityCmaintenanceEnables users to patrol QingSoft U+ courses, track homework and experiments, read objective questions into structured briefs for a connected MCP client model to answer, fill and verify selections, and optionally submit, while handing subjective, programming, report and file work back to the human.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables reading homework requirements, questions, and attachment text, along with querying course schedules, materials, and deadlines from the Xuexitong platform.MIT
- AlicenseNot gradedqualityCmaintenanceEnables an agent to log into the xxt (cx) homework platform, list courses and assignments, read question details with answer-format guidance, and submit answers — optionally as a dry run. Handles login via a real local browser or manually supplied cookies.2MIT