Skip to main content
Glama
Sign In
cc98-mcp

cc98-mcp

by EviterLesRoses2
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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

连接与登录状态自检

Related MCP server: ZSXQ Fetcher

网络要求

按优先级自动选择（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": "你的密码"
      }
    }
  }
}

致谢

Available Tools

10 tools
cc98_downloadA

将 CC98 帖子中的图片或附件文件下载到本地文件夹。url 取自帖子内容里的 [图片: …] 或 [文件: …] 占位符。返回保存路径。重要：交付给用户时必须保留原始文件（docx/pdf 原样给出），不要转换成 markdown/txt——转换会丢失内嵌图片并产生乱码。需要阅读内容时另行解析，但交付物始终是原始文件。

Inputs: url (required), dir, filename.

cc98_get_board_topicsC

获取某个版面的主题帖列表。best=true 时返回精华帖。

Inputs: board_id (required), best, from, size.

cc98_get_imageA

下载并查看 CC98 帖子中的图片。url 取自 cc98_get_posts 返回内容里的 [图片: …] 占位符。返回图片本体，可直接查看。

Inputs: url (required).

cc98_get_postsA

读取某个主题帖的楼层内容（UBB 已清洗为纯文本）。1 楼即主楼。如需翻页，传 from=10、20……内容中的 [图片: …] 可用 cc98_get_image 查看，[图片/文件: …] 均可用 cc98_download 保存到本地。

Inputs: topic_id (required), from, size.

cc98_get_userA

查询 CC98 用户的公开资料及其最近发帖。提供 user_id 或 name 之一。

Inputs: name, user_id.

cc98_hot_topicsA

获取 CC98 热门话题：today=今日十大，weekly/monthly/history=本周/本月/历史十大。

Inputs: range.

cc98_list_boardsA

列出 CC98 全部分区和版面（版面 ID 可用于 cc98_get_board_topics）。

Inputs: no named parameters.

cc98_new_topicsC

获取全站最新发布的主题帖。

Inputs: from, size.

cc98_search_topicsA

在 CC98 论坛全站搜索主题帖。返回匹配的帖子列表（标题、版面、作者、回复数、时间）。后续可用 cc98_get_posts 读取帖子内容。

Inputs: keyword (required), from, size.

cc98_statusA

检查 CC98 连接状态：网络（校园网直连 / WebVPN）和登录是否正常。排查连接问题时先调用此工具。

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct function: downloading, browsing boards, reading posts, user info, hot topics, listing boards, new topics, search, and status. No overlap in purpose.

    Naming Consistency4/5

    All tools start with 'cc98_' and mostly follow a verb_noun pattern (e.g., cc98_get_posts, cc98_search_topics). Minor inconsistency with cc98_hot_topics (adjective_noun) and cc98_status (noun only), but overall clear.

    Tool Count5/5

    10 tools is well-scoped for a forum reader: covers browsing, searching, reading, downloading, and status checking. Neither too few nor too many.

    Completeness2/5

    The tool set is read-only; missing create, update, delete operations for posts, topics, replies, or user interaction. Significant gap for full forum support.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-toolkit

      studiopig
      A
      license
      Not graded
      quality
      D
      maintenance
      A plug-and-play MCP toolkit providing AI agents with web search (Chinese sources prioritized), file operations, and shell command execution capabilities.
      2
      MIT

    • ZSXQ Fetcher

      leonardleelbq-jpg
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read and manipulate ZSXQ (知识星球) content via MCP, allowing listing groups, searching posts, downloading and summarizing content through natural language.
      9
      MIT

    • NGA MCP Server

      superboy724
      F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to browse and search NGA forum posts, including browsing forum sections, viewing post details with replies, and searching posts by keyword.
      -

    • nwafu-mcp

      unielevotor
      A
      license
      A
      quality
      C
      maintenance
      Provides MCP tools for querying and summarizing Northwest A&F University campus information, including trending QQ channel posts, official website notices/events/competitions, and cross-site custom searches with Markdown output and source links.
      4
      MIT