Ssumcp

@hoeongj

About Ssumcp

숭실대학교의 모든 공개/개인 정보 제공과 자동화 에이전트 기능을 MCP 표준 도구로 제공하여 공개 서버

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ssuMCP": {
      "url": "https://ssumcp.duckdns.org/mcp"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

What types of tools are available?

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.