ssuai-frontend

Name: ssuai-frontend
Author: hoeongj

web MCP Server

AI assistant for Soongsil University students — REST + MCP server + Next.js dashboard, all read-only public campus data.

byhoeongj

Verified

webweb

4 views1 stars0 forksv0.1.0MIT

View on GitHub Homepage Docs

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 2mo ago.

Verified

Source: github-topic:model-context-protocol
Stars: 1
Last synced: 2mo ago
Install: Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions

Tools

Resources

Prompts

Standard I/O

Transport

Available Tools (7)

UI

Tailwind CSS 3, shadcn/ui, Radix UI

NEXT_PUBLIC_SSUAI_API_BASE

ssuMCP 서버 URL

Vercel

--- ## 프로젝트 구조 ``` app/ auth/ # SSO 콜백, 로그인 페이지 chat/ # 챗봇 UI mcp/auth/ # 도서관 세션 UI components/ # 기능별·공통 UI 컴포넌트 contexts/ # 도서관 인증 컨텍스트 (LibraryAuthContext) hooks/ # TanStack Query 훅 + u-SAINT 인증(useSaintAuth·프로바이더) · 세션 가드 lib/ api/ # 타입 안전 API 클라이언트 api/client.ts # fetch 래퍼 — envelope 파싱, ApiError docs/ # 제품 문서, 아키텍처, ADR ``` --- ## 로컬 개발 ```bash cp .env.example .env.local # NEXT_PUBLIC_SSUAI_API_BASE=https://ssumcp.duckdns.org pnpm install pnpm dev # http://localhost:3000 ``` 로컬 ssuMCP 없이도 프로덕션 서버(`https://ssumcp.duckdns.org`)를 가리키면 바로 동작한다. ### 검증 ```bash pnpm lint pnpm typecheck pnpm test pnpm build ``` --- ## 환경 변수

SSUAI_API_PROXY_TARGET

(서버 전용) `/api/*` 프록시 대상 오버라이드. 설정 시 `NEXT_PUBLIC_SSUAI_API_BASE`보다 우선

SSUAGENT_BASE_URL

(서버 전용) `/api/agent` 프록시가 전달하는 ssuAgent 서버 URL. 미설정 시 `NEXT_PUBLIC_SSUAGENT_BASE_URL` → `https://ssuagent.duckdns.org` 순으로 폴백

NEXT_PUBLIC_SSUAGENT_BASE_URL

(공개·레거시) ssuAgent 서버 URL 폴백값. 주로 로컬 개발용

AGENT_API_KEY

(서버 전용) `/api/agent` 프록시가 ssuAgent 호출 시 주입하는 `X-Agent-Key` 자격증명. 브라우저에 노출되지 않으며, 미설정 시 헤더를 보내지 않아 게이트가 no-op이 됨

Works Well With - Skills

opencli-usage

Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv). Covers installation, command reference, and output formats for 87+ adapters.

5841 starsHas guide

Tavily Web Search

AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.

381 starsHas guide

ComPDF Conversion CLI

MUST use for ANY PDF or image format conversion task — converting PDF and images (JPG/JPEG/PNG/BMP/TIFF/TIF/WEBP/JPEG2000) to 10 formats (Word, Excel, PPT, H...

100 starsHas guide

Web Search Plus

Unified multi-provider web search and URL extraction skill with intelligent auto-routing across Serper, Brave, Tavily, Querit, Linkup, Exa, Firecrawl, Perple...

99 starsHas guide