datagsm-mcp
datagsm-mcp
DataGSM(광주소프트웨어마이스터고등학교 OpenAPI + OAuth 서비스) MCP 서버
Claude가 DataGSM의 학생, 동아리, 급식, 학사일정 데이터를 직접 조회하고, 기술 문서를 검색하며, OAuth 흐름을 안내받을 수 있습니다.
도구 목록
도구 | 인증 | 설명 |
| 불필요 | 키워드로 DataGSM 공식 문서 검색 |
| 불필요 | 특정 URL의 문서 페이지 조회 |
| 불필요 | 전체 문서 목록 조회 |
| 불필요 | API Key Scope 목록과 권한 설명 |
| 불필요 | OAuth PKCE 흐름 설명 및 Authorization URL 생성 |
| API Key | 학생 목록 조회 (학년/반/전공 등 필터) |
| API Key | 동아리 목록 조회 |
| API Key | 프로젝트 목록 조회 |
| API Key | NEIS 급식 정보 조회 |
| API Key | NEIS 학사일정 조회 |
| API Key | NEIS 시간표 조회 |
Related MCP server: Canvas MCP Server
설치 및 설정
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json 에 추가:
{
"mcpServers": {
"datagsm": {
"command": "npx",
"args": ["-y", "datagsm-mcp"],
"env": {
"DATAGSM_API_KEY": "your-api-key"
}
}
}
}Claude Code
claude mcp add datagsm -e DATAGSM_API_KEY=your-api-key -- npx -y datagsm-mcp환경변수
변수 | 필수 | 기본값 | 설명 |
| 데이터 조회 시 | — | OpenAPI 인증 키 |
| Bearer 사용 시 | — | OAuth Access Token |
| 선택 |
| OpenAPI 서버 URL |
| 선택 |
| OAuth 서버 URL |
| 선택 |
| 문서 목록 URL |
로컬 개발
git clone https://github.com/your-org/datagsm-mcp
cd datagsm-mcp
npm install
npm run build
# MCP Inspector로 테스트
npx @modelcontextprotocol/inspector node build/index.js배포
Git 태그 푸시 시 자동으로 npm에 배포됩니다:
# package.json version 업데이트 후
git tag v1.0.0
git push origin v1.0.0GitHub 저장소 Settings > Secrets에 NPM_TOKEN을 등록해야 합니다.
Available Tools
11 toolsdescribe_scopesDataGSM API Key Scope 목록ARead-onlyIdempotent
DataGSM API Key의 모든 권한 Scope와 설명을 반환합니다. API Key 발급 시 어떤 Scope를 요청해야 하는지 안내할 때 사용하세요.
Inputs: filter.
explain_oauth_flowDataGSM OAuth 흐름 안내ARead-only
DataGSM OAuth 2.0 Authorization Code + PKCE 흐름을 단계별로 설명합니다. clientId를 제공하면 실제 Authorization URL을 생성합니다.
Inputs: clientId, redirectUri, scopes, state.
get_clubs동아리 목록 조회ARead-only
DataGSM에서 동아리 목록을 조회합니다. 동아리 종류, 운영 상태 등으로 필터링할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.
Inputs: clubId, clubName, clubType, clubStatus, +6 more.
get_docDataGSM 특정 문서 조회ARead-onlyIdempotent
DataGSM 문서 사이트의 특정 URL 페이지 내용을 가져옵니다. search_docs로 찾은 URL을 직접 조회하거나, 알고 있는 문서 경로를 바로 읽을 때 사용하세요.
Inputs: url (required).
get_meals급식 정보 조회ARead-only
NEIS 연동 급식 정보를 조회합니다. 특정 날짜 또는 기간의 급식 메뉴와 알레르기 정보를 확인할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.
Inputs: date, fromDate, toDate.
get_projects프로젝트 목록 조회ARead-only
DataGSM에서 프로젝트 목록을 조회합니다. 동아리별, 상태별로 필터링할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.
Inputs: projectId, projectName, clubId, status, +4 more.
get_schedules학사일정 조회ARead-only
NEIS 연동 학사일정을 조회합니다. 특정 날짜 또는 기간의 행사 및 학사 일정을 확인할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.
Inputs: date, fromDate, toDate.
get_students학생 목록 조회ARead-only
DataGSM에서 학생 목록을 조회합니다. 학년, 반, 전공 등 다양한 조건으로 필터링할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.
Inputs: studentId, name, email, grade, +14 more.
get_timetables시간표 조회ARead-only
NEIS 연동 시간표를 조회합니다. 학년과 반을 지정하고 날짜 또는 기간을 입력해야 합니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.
Inputs: grade (required), classNum (required), date, fromDate, +1 more.
list_docsDataGSM 문서 목록ARead-onlyIdempotent
DataGSM 공식 문서의 전체 페이지 목록과 URL을 반환합니다. 어떤 문서가 있는지 파악하거나 search_docs 전에 목록을 확인할 때 사용하세요.
Inputs: no named parameters.
search_docsDataGSM 문서 검색ARead-onlyIdempotent
DataGSM 공식 문서에서 키워드와 관련된 페이지를 찾아 내용을 반환합니다. API 사용법, OAuth 흐름, SDK 안내, Scope 정보 등을 검색할 때 사용하세요.
Inputs: query (required), maxResults.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose: scopes, OAuth flow, clubs, meals, projects, schedules, students, timetables, and documentation (list, search, get). No overlapping functionality.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_clubs, list_docs, describe_scopes). No mixing of conventions.
11 tools is appropriate for the server's purpose—covering authentication info, data retrieval (clubs, projects, students, meals, schedules, timetables), and documentation. Well-scoped.
The tool surface covers the main informational needs (read operations for key entities and documentation). Missing create/update/delete operations, but given the server's likely read-only purpose, only minor gaps remain (e.g., no user info tool).
Related MCP Connectors
Provides tools for searching Google Workspace documentation and much more.
Search and read the Claude Platform documentation and API reference.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to perform comprehensive read and write operations on Google Docs, Sheets, and Drive folders. It supports file management, content searching, and provides resource access via custom URI schemes for seamless project context integration.MIT
- FlicenseNot gradedqualityDmaintenanceConnects Claude to the Canvas LMS REST API, enabling natural language queries about courses, assignments, grades, deadlines, and announcements.1-
- AlicenseBqualityCmaintenanceEnables Claude to interact with Canvas LMS, allowing natural language queries about courses, deadlines, grades, and feedback.29MIT
- AlicenseBqualityBmaintenanceEnables Claude to query your KRÉTA student data locally and read-only, including timetables, homework, grades, tests, and absences, using your own credentials via OAuth/PKCE.203Apache 2.0