📚 cx-mcp

xxt（cx）作业协议 MCP Server

接入后，agent 一条龙完成：选课 → 列作业 → 读题 → 写答案 → 提交

📦 依赖

npm install

Related MCP server: XIPU MCP

🔧 配置

在 mcpServers 中添加（/path/to/cx-mcp 替换为你本机的克隆路径）：

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

🚀 用法

用户只需告诉 agent 要做哪个（哪些）课程的作业：

👤 用户：做 xx 课的作业
   └─ 🤖 agent 自主完成
        ① cx_list_courses     找课程
        ② cx_list_homework    列作业
        ③ cx_get_homework     读题目（返回作答格式说明）
        ④ 按格式写答案
        ⑤ cx_submit_homework  提交（拿不准先 dryRun: true）

🔑 登录

未登录时，任何业务工具返回 { "error": "NOT_LOGGED_IN", "need": { … } }。两种恢复方式：

方式一：浏览器登录（推荐）

cx_login_start（可选带 username/password；验证码/滑块/扫码由用户在弹出的真实浏览器窗口里手动完成）
→ cx_login_status（轮询直到 success）
→ 成功后自动抓取全部 cookie（含 HttpOnly）和登录浏览器的 UA 一并保存

方式二：agent 自行交付

agent 自己拿到含 _uid / UID / vc3 / uf / _d 的整段 Cookie 请求头字符串后调 cx_set_cookies（建议同时给 userAgent，即 Cookie 来源浏览器的 UA —— 客户端会用它发请求，保持请求指纹与登录态同源）。注意 vc3 是 HttpOnly，document.cookie 读不到，需从网络请求头或能读 HttpOnly 的自动化 cookie API 获取。

两种方式保存后均可用 cx_check_login 确认 loggedIn: true。

📝 answer 值格式

带文件/图片的作业：

• 题目给的附件/图片：cx_get_homework 返回的题目里带 attachments（objectid/文件名/类型/大小）和 stemImages（图片 URL）；附件用 cx_get_attachment_download 拿带签名的下载直链；

• 答案需要交文件/图片：cx_upload_attachment 上传本地文件，返回 answerHtml —— 原样拼进该题 answer<qid> 的 HTML 里再提交（图片自动用 <img>，文件自动用附件 iframe，与网页端产物同构）。

🧰 工具一览

📄 License

MIT

⚠️ 免责声明

• 本项目仅供学习与技术研究（协议分析、接口自动化），使用前请了解并遵守你所在学校/机构的规定及相关法律法规。

• 是否使用、如何使用由使用者自行决定；因使用本工具产生的一切后果（包括但不限于账号处罚、作业/成绩作废、学术处分等）由使用者本人承担。

• 作者不鼓励、不支持任何形式的学术不端行为，请勿将本项目用于商业用途或大规模滥用。

• 一经使用，即视为你已阅读、理解并同意上述内容。