What is ssuMCP?
ssuMCP is a public server that provides Soongsil University campus information as MCP (Model Context Protocol) standard tools, and also serves as a REST API server for the ssuAI web client. It allows LLM agents (e.g., Claude Desktop) to directly fetch school data in response to natural language queries.
How to use ssuMCP?
Configure your MCP client (Claude Desktop, Cursor, etc.) with the URL https://ssumcp.duckdns.org/mcp. Public tools require no authentication. For personal tools (grades, schedule, library loans), call start_auth to receive a login URL, authenticate with your Soongsil account in a browser, then pass the returned mcp_session_id in subsequent tool calls.
Key features of ssuMCP
- Public tools: campus meals, library books, notices, facilities search.
- Personal tools (authenticated): schedule, grades, chapel attendance, scholarships.
- One Spring Boot process serves both REST and MCP via Streamable HTTP.
- Mock connector mode enables full offline development and testing.
- Single‑flight cache and WAF cookie isolation for reliable crawling.
- Read‑only tools with explicit hints; write tools use a two‑step confirm pattern.
Use cases of ssuMCP
- Ask “What’s today’s cafeteria menu?” and get the live menu.
- Search library books by keyword and view availability.
- Check your current semester grades without logging into the portal.
- Look up campus facility locations or recent university notices.
评论