Skip to main content
Glama

datagsm-mcp

DataGSM(광주소프트웨어마이스터고등학교 OpenAPI + OAuth 서비스) MCP 서버

Claude가 DataGSM의 학생, 동아리, 급식, 학사일정 데이터를 직접 조회하고, 기술 문서를 검색하며, OAuth 흐름을 안내받을 수 있습니다.

도구 목록

도구

인증

설명

search_docs

불필요

키워드로 DataGSM 공식 문서 검색

get_doc

불필요

특정 URL의 문서 페이지 조회

list_docs

불필요

전체 문서 목록 조회

describe_scopes

불필요

API Key Scope 목록과 권한 설명

explain_oauth_flow

불필요

OAuth PKCE 흐름 설명 및 Authorization URL 생성

get_students

API Key

학생 목록 조회 (학년/반/전공 등 필터)

get_clubs

API Key

동아리 목록 조회

get_projects

API Key

프로젝트 목록 조회

get_meals

API Key

NEIS 급식 정보 조회

get_schedules

API Key

NEIS 학사일정 조회

get_timetables

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

환경변수

변수

필수

기본값

설명

DATAGSM_API_KEY

데이터 조회 시

—

OpenAPI 인증 키

DATAGSM_BEARER_TOKEN

Bearer 사용 시

—

OAuth Access Token

DATAGSM_BASE_URL

선택

https://openapi.datagsm.kr

OpenAPI 서버 URL

DATAGSM_AUTH_BASE_URL

선택

https://oauth.datagsm.kr

OAuth 서버 URL

DATAGSM_LLMS_TXT_URL

선택

https://docs.datagsm.kr/llms.txt

문서 목록 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.0

GitHub 저장소 Settings > Secrets에 NPM_TOKEN을 등록해야 합니다.

Available Tools

11 tools
describe_scopesDataGSM API Key Scope 목록A
Read-onlyIdempotent

DataGSM API Key의 모든 권한 Scope와 설명을 반환합니다. API Key 발급 시 어떤 Scope를 요청해야 하는지 안내할 때 사용하세요.

Inputs: filter.

explain_oauth_flowDataGSM OAuth 흐름 안내A
Read-only

DataGSM OAuth 2.0 Authorization Code + PKCE 흐름을 단계별로 설명합니다. clientId를 제공하면 실제 Authorization URL을 생성합니다.

Inputs: clientId, redirectUri, scopes, state.

get_clubs동아리 목록 조회A
Read-only

DataGSM에서 동아리 목록을 조회합니다. 동아리 종류, 운영 상태 등으로 필터링할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.

Inputs: clubId, clubName, clubType, clubStatus, +6 more.

get_docDataGSM 특정 문서 조회A
Read-onlyIdempotent

DataGSM 문서 사이트의 특정 URL 페이지 내용을 가져옵니다. search_docs로 찾은 URL을 직접 조회하거나, 알고 있는 문서 경로를 바로 읽을 때 사용하세요.

Inputs: url (required).

get_meals급식 정보 조회A
Read-only

NEIS 연동 급식 정보를 조회합니다. 특정 날짜 또는 기간의 급식 메뉴와 알레르기 정보를 확인할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.

Inputs: date, fromDate, toDate.

get_projects프로젝트 목록 조회A
Read-only

DataGSM에서 프로젝트 목록을 조회합니다. 동아리별, 상태별로 필터링할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.

Inputs: projectId, projectName, clubId, status, +4 more.

get_schedules학사일정 조회A
Read-only

NEIS 연동 학사일정을 조회합니다. 특정 날짜 또는 기간의 행사 및 학사 일정을 확인할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.

Inputs: date, fromDate, toDate.

get_students학생 목록 조회A
Read-only

DataGSM에서 학생 목록을 조회합니다. 학년, 반, 전공 등 다양한 조건으로 필터링할 수 있습니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.

Inputs: studentId, name, email, grade, +14 more.

get_timetables시간표 조회A
Read-only

NEIS 연동 시간표를 조회합니다. 학년과 반을 지정하고 날짜 또는 기간을 입력해야 합니다. API Key(DATAGSM_API_KEY)가 환경변수에 설정되어 있어야 합니다.

Inputs: grade (required), classNum (required), date, fromDate, +1 more.

list_docsDataGSM 문서 목록A
Read-onlyIdempotent

DataGSM 공식 문서의 전체 페이지 목록과 URL을 반환합니다. 어떤 문서가 있는지 파악하거나 search_docs 전에 목록을 확인할 때 사용하세요.

Inputs: no named parameters.

search_docsDataGSM 문서 검색A
Read-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

    A4.1/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: scopes, OAuth flow, clubs, meals, projects, schedules, students, timetables, and documentation (list, search, get). No overlapping functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_clubs, list_docs, describe_scopes). No mixing of conventions.

    Tool Count5/5

    11 tools is appropriate for the server's purpose—covering authentication info, data retrieval (clubs, projects, students, meals, schedules, timetables), and documentation. Well-scoped.

    Completeness4/5

    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

    Related MCP Servers