把你的 AI 变成 ExamHub 助教

MCP Streamable HTTP

ExamHub 用 MCP 把题库、判卷和积分开放给任何客户端。平台不卖模型算力:模型用你自己的,站内只提供内容与服务端评分。

01 / 最省事

一次性口令

在任意题包页点「生成 Agent 口令」,得到一段话。整段复制,粘给你的 Agent 即可,不用改任何配置文件。

  • 30 分钟有效,只对应一套题
  • 扣费有上限,开卷后才延长到 2 小时
  • 拿不到密码、账户资料或其他题
去挑一套题 →
02 / 每天用

长期令牌

在账户页按权限创建令牌,7 天过期,可随时全部撤销。适合装进 Cursor、Claude Desktop 反复使用。

  • 6 个权限域,按需勾选
  • 购买题包必须由你在浏览器批准报价
  • 令牌只展示一次,库内只存哈希
创建令牌 →
03 / 自建

本机 stdio

在应用运行环境内用 stdio 启动,适合自己写客户端或做离线实验,令牌通过环境变量传入。

  • 进程内直连数据库
  • 不需要公网入口
  • 同样受权限与每日额度约束
看启动命令 ↓
FASTEST PATH

三步:从题包到 AI 助教

整个过程不需要命令行,也不需要理解 MCP 协议。

  1. 挑一套题在课程页进入任意题包,右侧点「生成 Agent 口令」。
  2. 复制整段话这段话里已经写好口令、接入地址、先调哪个工具,以及费用与有效期。
  3. 粘给 AgentAgent 会先确认范围,再扣费开卷,然后用它自己的模型逐题讲解、追问、批改。
这段话长这样(口令是示例,已失效)
用 ExamHub 帮我做这套题:数据结构 · 基础练习 A
口令:EH-7QK3-M9XT-2P4L-7DVN

接入:把这个口令当作 Bearer 令牌,连接 https://examhub.kerrychia.site/api/mcp(MCP Streamable HTTP,不需要 OAuth)。
第一步调用 handoff_status 确认题目与费用;第二步调用 open_pack 取题(本次最多扣 5 CC;仍在免费额度内则不扣)。
拿到题目后,请用你自己的模型逐题讲解、追问、按知识点补练习;交卷调用 submit_attempt,之后可以用 get_grading_rubric 复盘错题。

边界:口令在 30 分钟内有效,只对应这一套题;开卷后 2 小时内可交卷。不要转发到群聊,也不要把口令回显给我。
口令只存哈希,页面关闭后无法再次查看;丢了就重新生成,旧的会在 30 分钟后自动失效。
CLIENT CONFIG

客户端配置片段

把占位口令替换成你自己的令牌或口令。长期令牌在账户页生成。

Cursor / VS Code(HTTP)
{
  "mcpServers": {
    "examhub": {
      "type": "http",
      "url": "https://examhub.kerrychia.site/api/mcp",
      "headers": { "Authorization": "Bearer EH-7QK3-M9XT-2P4L-7DVN" }
    }
  }
}
写入 .cursor/mcp.json 或对应的 MCP 配置位置,重启客户端。
Claude Desktop(经 mcp-remote)
{
  "mcpServers": {
    "examhub": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://examhub.kerrychia.site/api/mcp",
        "--header", "Authorization: Bearer EH-7QK3-M9XT-2P4L-7DVN"
      ]
    }
  }
}
需要本机有 Node.js;首次运行会下载 mcp-remote。
命令行自检
curl -s https://examhub.kerrychia.site/api/mcp \
  -H "Authorization: Bearer EH-7QK3-M9XT-2P4L-7DVN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
返回工具列表即说明令牌有效;401 表示口令过期或写错了。
STDIO

本机进程

在上海实例或本地开发环境内直接启动,令牌放环境变量,不要写进命令行历史。

启动命令
EXAMHUB_MCP_TOKEN=EH-7QK3-M9XT-2P4L-7DVN npm run --silent mcp
stdio 进程需要与应用相同的 DATABASE_URL。
TOOLS

Agent 能做什么

口令与长期令牌挂载的是两套不同的工具集:口令更窄,令牌更全。

口令模式作用
handoff_status看这个口令能做什么:绑定的题、剩余预算、有效期
list_packs目录口令专用:列已上架题包,挑一套
open_pack扣费并开卷,返回题干与选项(不含答案);重复调用不重复扣
submit_attempt交卷,服务端判分
get_result读成绩
get_grading_rubric交卷后读答案与解析,用来复盘
get_balances读 CC / RP 余额
账户令牌作用
get_profile读校区与昵称
search_packs / get_pack / get_leaderboard搜题包、看元信息、看双榜
quote_pack / acquire_pack出报价;购买必须先在浏览器批准报价
get_pack_content / submit_attempt开卷拉题、交卷判分
get_result / get_grading_rubric成绩与解析
get_balances / get_credit_history余额与流水
BOUNDARIES

安全边界

先试一次口令,再决定要不要配令牌

口令模式最适合演示与合作:一段话发过去,对方就能用他自己的 AI 做你这套题。