ssumcp 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +115 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# ssumcp
|
|
2
|
+
|
|
3
|
+
숭실대학교 캠퍼스 정보를 **MCP(Model Context Protocol) 표준 도구**로 제공하는 공개 서버.
|
|
4
|
+
|
|
5
|
+
Claude Desktop, Cursor 및 그 외 MCP 클라이언트에서 사용할 수 있습니다.
|
|
6
|
+
|
|
7
|
+
[](https://github.com/hoeongj/ssuMCP/actions/workflows/ci.yml)
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## 빠른 시작 (로컬 실행)
|
|
12
|
+
|
|
13
|
+
Java 21 이상 필요 ([Temurin 다운로드](https://adoptium.net))
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npx ssumcp
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
서버가 `http://localhost:8080`에서 실행됩니다.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## MCP 클라이언트 연결
|
|
24
|
+
|
|
25
|
+
### 원격 서버 (설치 없이 바로 사용)
|
|
26
|
+
|
|
27
|
+
```json
|
|
28
|
+
{
|
|
29
|
+
"mcpServers": {
|
|
30
|
+
"ssuMCP": {
|
|
31
|
+
"url": "https://ssumcp.duckdns.org/mcp"
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### 로컬 서버 (npx로 직접 실행)
|
|
38
|
+
|
|
39
|
+
```json
|
|
40
|
+
{
|
|
41
|
+
"mcpServers": {
|
|
42
|
+
"ssuMCP": {
|
|
43
|
+
"url": "http://localhost:8080/mcp"
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
**Claude Desktop** 설정 파일 위치:
|
|
50
|
+
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
51
|
+
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## 공개 도구 (인증 불필요)
|
|
56
|
+
|
|
57
|
+
| 도구 | 설명 |
|
|
58
|
+
|------|------|
|
|
59
|
+
| `get_today_meal` | 오늘 학식 메뉴 |
|
|
60
|
+
| `get_meal_by_date` | 날짜별 학식 |
|
|
61
|
+
| `get_dorm_weekly_meal` | 레지던스홀 주간 식단 |
|
|
62
|
+
| `search_campus_facilities` | 교내 시설 검색 |
|
|
63
|
+
| `search_library_book` | 중앙도서관 도서 검색 |
|
|
64
|
+
| `get_recent_notices` | 학교 공지사항 최신 목록 |
|
|
65
|
+
| `search_notices` | 공지사항 키워드 검색 |
|
|
66
|
+
| `list_notice_categories` | 공지 카테고리 목록 |
|
|
67
|
+
| `get_notice_detail` | 공지 본문 전체 조회 |
|
|
68
|
+
| `get_active_notices` | 진행 중(마감 전) 공지 |
|
|
69
|
+
| `get_department_notices` | 학과/부서별 공지 |
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## 개인 도구 (u-SAINT / LMS / 도서관 인증 필요)
|
|
74
|
+
|
|
75
|
+
**인증 흐름:**
|
|
76
|
+
|
|
77
|
+
1. `start_auth(provider="SAINT")` 호출 → `loginUrl`과 `mcpSessionId` 수신
|
|
78
|
+
2. `loginUrl`을 브라우저에서 열어 숭실대 계정으로 로그인
|
|
79
|
+
3. 이후 개인 도구 호출 시 `mcp_session_id` 파라미터 전달
|
|
80
|
+
|
|
81
|
+
| 도구 | provider | 설명 |
|
|
82
|
+
|------|----------|------|
|
|
83
|
+
| `start_auth` | - | 로그인 URL 발급 |
|
|
84
|
+
| `get_auth_status` | - | 세션 상태 확인 |
|
|
85
|
+
| `logout_provider` | - | 특정 provider 해제 |
|
|
86
|
+
| `logout_all` | - | 세션 전체 해제 |
|
|
87
|
+
| `get_my_schedule` | SAINT | 시간표 |
|
|
88
|
+
| `get_my_grades` | SAINT | 성적 |
|
|
89
|
+
| `get_my_chapel_info` | SAINT | 채플 출석 현황 |
|
|
90
|
+
| `check_graduation_requirements` | SAINT | 졸업 요건 |
|
|
91
|
+
| `get_my_scholarships` | SAINT | 장학금 수혜 내역 |
|
|
92
|
+
| `get_my_assignments` | LMS | 과제 및 퀴즈 목록 |
|
|
93
|
+
| `get_library_seat_status` | LIBRARY | 중앙도서관 층별 좌석 현황 |
|
|
94
|
+
| `get_my_library_loans` | LIBRARY | 도서관 대출 현황 |
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## 환경 변수
|
|
99
|
+
|
|
100
|
+
| 변수 | 기본값 | 설명 |
|
|
101
|
+
|------|--------|------|
|
|
102
|
+
| `PORT` | `8080` | 서버 포트 |
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 관련 링크
|
|
107
|
+
|
|
108
|
+
- [GitHub 저장소](https://github.com/hoeongj/ssuMCP)
|
|
109
|
+
- [ssuAI 웹 클라이언트](https://github.com/hoeongj/ssuAI)
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 라이선스
|
|
114
|
+
|
|
115
|
+
MIT
|