cc98-mcp
cc98-mcp enables AI assistants to search, read, and aggregate posts from the Zhejiang University campus forum CC98, using official read-only API tools.
README
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,默认):
- 直连 — 校园网内,或校外但 IPv6 可达
api.cc98.org(CC98 有公网 IPv6) - 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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.