datagsm-mcp
Enables Claude to query DataGSM's student, club, meal, and schedule data, as well as search documentation and guide OAuth flows.
README
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을 등록해야 합니다.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.