cc98-mcp

CC98（浙江大学校网论坛）的 MCP server，让 Claude 可以搜索、阅读、整合论坛信息。基于 CC98 官方 REST API（api.cc98.org，OpenID 认证），全部工具只读，不会发帖/回帖/点赞。

工具列表

工具	功能
cc98_search_topics	全站搜索主题帖
cc98_get_posts	读取帖子楼层内容（UBB 已清洗为纯文本）
cc98_hot_topics	今日/本周/本月/历史十大
cc98_new_topics	全站最新主题帖
cc98_list_boards	全部分区与版面
cc98_get_board_topics	某版面的主题帖（可只看精华）
cc98_get_user	用户公开资料及最近发帖
cc98_get_image	下载帖子中的图片并返回图片本体（供 AI 直接查看）
cc98_download	将帖子中的图片/附件下载到本地（默认 ~/Downloads/cc98）
cc98_status	连接与登录状态自检

网络要求

按优先级自动选择（CC98_WEBVPN_MODE=auto，默认）：

1. 直连 — 校园网内，或校外但 IPv6 可达 api.cc98.org（CC98 有公网 IPv6）
2. WebVPN — 直连失败时，用浙大统一认证账号自动登录 webvpn.zju.edu.cn 中转

也可以强制：CC98_WEBVPN_MODE=direct（只直连）或 vpn（只走 WebVPN）。

配置

环境变量：

变量	必需	说明
CC98_USERNAME	是	CC98 论坛用户名
CC98_PASSWORD	是	CC98 论坛密码
CC98_WEBVPN_MODE	否	auto（默认）/ direct / vpn
ZJU_USERNAME	否	浙大统一认证学号（仅 WebVPN 需要）
ZJU_PASSWORD	否	浙大统一认证密码（仅 WebVPN 需要）

WebVPN 若提示需要验证码，先在浏览器登录一次 webvpn.zju.edu.cn 再重试。

构建与接入

git clone https://github.com/<your-account>/cc98-mcp.git
cd cc98-mcp
npm install && npm run build

接入 Claude Code（把 /path/to/cc98-mcp 换成你 clone 的实际路径）：

claude mcp add cc98 \
  -e CC98_USERNAME=你的用户名 \
  -e CC98_PASSWORD=你的密码 \
  -- node /path/to/cc98-mcp/dist/index.js

或在 Claude Desktop 的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "cc98": {
      "command": "node",
      "args": ["/path/to/cc98-mcp/dist/index.js"],
      "env": {
        "CC98_USERNAME": "你的用户名",
        "CC98_PASSWORD": "你的密码"
      }
    }
  }
}

致谢

• API 端点与 WebVPN 实现参考 Lucent-Snow/CC98-CLI（MIT）
• CC98 API 文档 / ZJU-CC98/Forum