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 시간표 조회 |

설치 및 설정

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을 등록해야 합니다.