Ssumcp

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.

FAQ from ssuMCP

What types of tools are available?

Public tools (no auth) provide meals, library books, notices, and facilities. Personal tools (requires Soongsil University account) access schedule, grades, chapel info, scholarships, LMS assignments, and library loans.

How do I authenticate for personal tools?

Call start_auth to get a login URL. Open it in a browser and log in with your university account. Then pass the mcp_session_id in subsequent tool calls. Sessions are encrypted with AES‑256‑GCM.

What is the MCP endpoint?

The endpoint is https://ssumcp.duckdns.org/mcp using Streamable HTTP transport.

Does it require any external dependencies?

For remote use, only an MCP client is needed. Local development requires Java 21, Gradle, and optionally PostgreSQL. Mock mode works offline with no external network.

Are any write/state-changing operations supported?

All current tools are read‑only (readOnlyHint=true). Write operations (e.g., reservations) are designed as a two‑step prepare_* + confirm_action pattern but are not yet implemented.