CSU-mcp

# CSU MCP A REST + MCP service that aggregates the unified authentication data of Central South University, allowing users to check grades, class schedules, campus buses, and job postings, and can be directly called by clients such as Claude, Kilocode, and VS Code using the `csu.*` tools. --- ## 1. Purpose - **REST API**: Provides unified interfaces such as `/api/v1/jwc/:id/:pwd/grade`, `/rank`, `/class/:term/:week`, `/bus/search/:start/:end/:day`, `/job/...`, etc. - **MCP Tools**: Automatically exposes `csu.grade`, `csu.rank`, `csu.classes`, `csu.bus_search`, `csu.jobs`, requiring no additional integration for AI assistants. - **Single Image Deployment**: API, MCP, and Landing are all packaged together, suitable for self-hosting or directly reusing public services. --- ## 2. Directly Connect to Public Server Public MCP Address: `http://8.162.3.110:13000` | Client | Configuration Example | | ------ | --------------------- | | 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 Extension | `"csu": { "type": "http", "url": "http://8.162.3.110:13000" }` | After saving, you can directly call the `csu.*` tools in the corresponding client without local deployment. --- ## 3. Pull and Run Your Own Image The image is synchronized on GHCR and Alibaba Cloud, and you can choose either one: ```bash docker pull ghcr.io/chendaile/csu-mcp:latest # or docker pull crpi-qpej8ufiacto12s1.cn-hangzhou.personal.cr.aliyuncs.com/csu-mcp/csu-mcp:<version> ``` Run: ```bash docker run -d \ --name csu-mcp \ -p 12000:12000 \ -p 13000:13000 \ <TARGET_IMAGE> ``` After starting: - `http://localhost:12000/` — REST API homepage, can directly call the interface with `token=csugo-token`. - `http://localhost:13000/` — MCP entry, local MCP clients should point to this address. If you need to customize the port or token, copy `configs/api/conf/app.conf`, modify it, and mount it with `-v /path/app.conf:/app/configs/api/conf/app.conf:ro` to override. Contributions via Issues / PRs are welcome.***