中南大学MCP服务

一个聚合中央南大学统一认证数据的REST+MCP服务，提供成绩、课程表、校车、招聘等信息，并可以直接被客户端如Claude/Kilocode/VS Code csu.* 工具调用。

---

1. 使用方法

• REST API：提供 /api/v1/jwc/:id/:pwd/grade、/rank、/class/:term/:week、/bus/search/:start/:end/:day、/job/... 等统一接口。
• MCP工具：自动开启 csu.grade、csu.rank、csu.classes、csu.bus_search、csu.jobs，AI助手无需额外集成。
• 单镜像部署：API、MCP、落地页全部打包，适合自托管或直接复用公共服务。

---

2. 直接连接到公共服务器

公共MCP地址：http://8.162.3.110:13000

客户端	配置示例
Kilocode	"csu": { "type": "streamable-http", "url": "http://8.162.3.110:13000" }
Claude Desktop	claude mcp add --transport http csu http://8.162.3.110:13000
VS Code MCP扩展	"csu": { "type": "http", "url": "http://8.162.3.110:13000" }

保存后，可以在相应的客户端直接调用 csu.* 工具，无需本地部署。

---

3. 自行运行镜像

镜像可以在GHCR和阿里云之间同步，可以选择其一：

docker pull ghcr.io/chendaile/csu-mcp:latest
# 或
docker pull crpi-qpej8ufiacto12s1.cn-hangzhou.personal.cr.aliyuncs.com/csu-mcp/csu-mcp:<版本号>

功能：

docker run -d \
  --name csu-mcp \
  -p 12000:12000 \
  -p 13000:13000 \
  <目标镜像>

启动后：

• http://localhost:12000/ —— REST API首页，可以通过 token=csugo-token 调整接口。
• http://localhost:13000/ —— MCP入口，本地MCP客户端可以指向这个地址。

如果需要自定义端口或令牌，复制并修改 configs/api/conf/app.conf 文件，通过 -v /path/app.conf:/app/configs/api/conf/app.conf:ro 挂载覆盖。欢迎Issue/PR。 ***