우리학교 알리미 (schoolinfo-mcp)
내 아이 학교, 검색하지 말고 물어보세요.
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิด학교알리미는 정보가 다 있는데, 막상 찾으려면 어디 있는지 모릅니다. 특히 수행평가 계획은 hwp 첨부파일 속에 숨어 있어 학부모가 열어보기도 어렵습니다.
전국 모든 초·중·고의 공시정보는 학교알리미에 공개돼 있습니다. 이 도구는 학교알리미 OpenAPI(정형 데이터 35종), kordoc(hwp→마크다운), 그리고 NEIS 개방포털(급식·학사일정·시간표)을 묶어서, 사이트를 헤매지 않고 학교명만으로 여러 학교를 한 표로 비교하고, hwp 첨부에 묻힌 수행평가 계획을 표로 풀어 봅니다. 학생수·동아리·방과후 같은 공시와 급식(알레르기 회피 필터)·학사일정·시험 D-day·이번주 브리핑까지 한 번에 받게 해줍니다.
세 가지 방법으로 쓸 수 있습니다 — 가장 쉬운 순서대로:
최근 정비: 학교 비교·수행평가 중심으로 화면을 재배치하고 평가계획 교과 아코디언·응답 캐시·모바일 표시를 다듬었습니다(2026-06, CHANGELOG 0.3.0). 이후 웹앱을 Vercel
school.gomdori.app으로 이전하고, 2026 행정구역 개편(전남광주통합특별시·인천 신설구·화성 분구)과 평가계획 학기·학년·과목 지정, 교육과정 편제(2-가) 조회를 추가했습니다(2026-07, 커밋 로그 참조).
브라우저만 있으면 됩니다. 아래 주소로 접속하세요:
맨 위 탭으로 세 가지 모드를 오갑니다 — 📋 수행평가·내신(첫 화면) · 📊 학교 비교(학교를 먼저 안 찾아도 지역+학교급만으로 비교표) · 🎓 대학 진학(전국 49개 대학 전공별 권장 이수과목, 내 선택과목을 골라두면 ✓로 대조).
수행평가·내신 모드는 이렇게 씁니다:
학교 찾기
(지역을 몰라도 됩니다. 전국에서 바로 찾아줘요. 시도/시군구로 좁혀 찾고 싶으면 지역으로 검색 탭.)인증키 발급도, 회원가입도 필요 없습니다. 링크만 알면 누구나 바로 쓸 수 있어요. 모바일 최적화(화면 안 잘리고, 단어 단위 줄바꿈, 큰 글씨 위계의 에디토리얼 디자인) — 카톡으로 링크 공유하면 다른 학부모도 그대로 사용.
설치하면 자연어로 그냥 물어볼 수 있습니다. "검색"이 아니라 "대화"입니다.
공식 원격 MCP는 통합 호스트 mcp.gomdori.app(fly 머신 1대에 MCP 5종 동거)의 /school 경로입니다. 연결만 하면 되고, 인증키는 서버에 있으니 각자 발급할 필요가 없어요.
Claude Code — 한 줄이면 끝:
claude mcp add --transport http schoolinfo https://mcp.gomdori.app/school
프로젝트 .mcp.json에 직접 적어도 됩니다:
{
"mcpServers": {
"schoolinfo": {
"type": "http",
"url": "https://mcp.gomdori.app/school"
}
}
}
Claude.ai 웹 — 설정 → 커넥터 → 커스텀 커넥터 추가 → URL에 https://mcp.gomdori.app/school 입력.
그 밖의 클라이언트(Claude Desktop·Cursor 등) — 원격 MCP를 직접 지원하지 않는 클라이언트는 stdio 브리지를 거칩니다:
{
"mcpServers": {
"schoolinfo": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.gomdori.app/school"]
}
}
}
인증키는 서버에 있으니 각자 발급할 필요가 없습니다. (Streamable HTTP, stateless — 세션 관리 없음)
본인 키로 로컬에서 돌리고 싶다면 (clone → build 후):
{
"mcpServers": {
"schoolinfo": {
"command": "node",
"args": ["C:/github_project/schoolinfo-mcp/dist/mcp.js"],
"env": { "SCHOOLINFO_API_KEY": "발급받은_인증키" }
}
}
}
인증키는 무료·즉시 발급입니다 → 발급 방법 macOS는
args경로만 바꾸면 됩니다. Claude/Cursor를 재시작하면 도구가 활성화됩니다. (로컬 구동에는 받은 hwp 파일을 직접 변환하는parse_evaluation_file도 포함됩니다. 원격 MCP에는 보안상 제외.)
설치 후, Claude에게 이렇게 그대로 말해보세요. (복사해서 붙여넣어도 됩니다)
🍱 급식·기본 정보
"서울 강남구 개포중학교 급식 어떻게 운영돼? 직영이야 위탁이야?"
"개포중학교 한 반에 몇 명이야? 학년별 학생수도 알려줘."
"우리 동네 노원구 중학교 중에 개교한 지 오래된 곳 찾아줘."
📋 수행평가 (이 도구의 핵심) — 학년·과목을 콕 집어 물어보세요
"자양중학교 2학년 수행평가 계획 보여줘. 과목별로 뭘 언제 평가하는지 표로."
"우리 애 자양중 1학년인데, 과학이랑 수학 수행평가만 자세히 알려줘."
"개포중학교 올해 수행평가 계획 보여줘. 과목별 반영비율이랑 시기 정리해줘."
"개포중 1학년 국어·영어·수학 수행평가만 표로 만들어줘. 언제 뭘 평가하는지."
"우리 애가 중2인데, 이번 학기 수행평가 일정 빠른 것부터 순서대로 알려줘. 준비물·과제 있으면 같이."
"자양중 3학년 영어 수행평가 항목이랑 배점, 정기시험 비율까지 정리해줘."
"이 학교 수행평가 100%인 과목이랑 지필고사 비중 높은 과목을 구분해줘."
🎭 학교 생활·활동
"개포중학교 동아리 어떤 게 있어? 방과후 프로그램도 같이 알려줘."
"이 학교 상담은 어떻게 운영돼? 학교폭력 예방교육은 얼마나 해?"
⚖️ 비교·판단 (전학·진학 고민)
"강남구 대청중학교랑 개포중학교 급식이랑 학급당 인원 비교해줘."
"분당 지역 중학교 몇 곳 학생수랑 동아리 비교해서 표로 보여줘."
📂 받은 파일 정리
"학교에서 받은 이 평가계획 hwp 파일에서 우리 애 학년 수행평가만 정리해줘" (파일 경로를 함께 알려주면 됨 —
C:\Downloads\2026_평가계획.hwp)
Claude가 알아서 학교를 찾고, hwp를 내려받아 변환하고, 표로 정리해줍니다. 학교코드·연도·파일 위치 같은 건 하나도 몰라도 됩니다.
"교과별(학년별) 교수·학습 및 평가 운영 계획"은 학부모가 가장 궁금해하지만 가장 찾기 어렵습니다. 이 항목은 학교알리미 OpenAPI에 없고 hwp 첨부파일로만 공시되기 때문입니다.
이 도구는 학교별 공시정보 웹의 내부 요청을 그대로 재현해서, 브라우저 없이 순수 HTTP로 평가계획 hwp/hwpx/pdf를 자동으로 내려받고, kordoc으로 파싱해 수행평가 표를 뽑아줍니다.
학교명 입력
│
▼
OpenAPI로 학교식별코드 조회 ──▶ 평가계획 첨부파일 목록 (POST)
│ │
│ ▼
└────────────────────▶ hwp/hwpx/pdf 자동 다운로드
│
▼
kordoc 파싱 → 수행평가 섹션 추출 → 표
실제 추출 예 (개포중학교):
학교마다 평가계획을 올리는 방식이 다른데, 알아서 맞춰 보여줍니다:
subject="국어"(특정 과목)·all=true(전체)로 골라 받습니다.개발자·파워유저용. 터미널에서 바로, 스케줄러로 자동 알림까지.
git clone https://github.com/chrisryugj/schoolinfo-mcp
cd schoolinfo-mcp
npm install
npm run build
# .env.local 파일 또는 환경변수
SCHOOLINFO_API_KEY=발급받은_인증키
NEIS_API_KEY=발급받은_NEIS_인증키 # 학사일정 기능용(선택) — https://open.neis.go.kr 무료 발급
NEIS_API_KEY는 급식·학사일정·이번주 브리핑(get_school_meal·get_school_schedule·get_school_week)에 쓰입니다. 없어도 나머지 공시 기능은 정상 동작합니다.
아래는 실제로 실행한 출력입니다.
$ schoolinfo search 서울 강남구 중학교 개포
## 개포중학교 (중학교)
| 항목 | 내용 |
|------|------|
| 설립 | 공립 |
| 교육청 | 서울특별시교육청 |
| 주소 | 서울특별시 강남구 선릉로 9 |
| 전화 | 02-2138-1631 |
| 홈페이지 | https://gaepo.sen.ms.kr |
| 학교코드 | S010000699 |
$ schoolinfo get 서울 강남구 중학교 개포중학교 급식
### 급식 실시 현황
| 항목 | 값 |
|------|------|
| 급식학생수 | 1090 |
| 운영방식 - 급식종류 | 직영 |
| 급식담당인력(명) - 영양(교)사 | 1 |
| 급식담당인력(명) - 조리사 | 1 |
| 급식담당인력(명) - 조리원 | 9 |
| 급식비율 | 100 |
$ schoolinfo get 서울 강남구 중학교 개포중학교 학년별
### 학년별·학급별 학생수
| 항목 | 값 |
|------|------|
| 1학년 학생수 | 300 |
| 2학년 학생수 | 374 |
| 3학년 학생수 | 410 |
| 총계 학생수 | 1090 |
| 총계 학급당 학생수 | 29.5 |
$ schoolinfo eval 서울 강남구 중학교 개포중학교
## 📄 2026학년도 개포중 학교교육과정 편성 운영 및 교수학습 평가 계획.hwpx (hwpx)
### 🎯 수행평가 관련 (3개)
| 과목 | 1학기 | 2학기 | 반영비율(%) | 만점 |
|------|-------|-------|------------|------|
| 국어 | 말하기·듣기 매체 활동 / 정기시험 중간·기말(선택형) | … | 30 | 100 |
| … | … | … | … | … |
과목별로 나뉜 학교는 목록을 먼저 보여줍니다:
$ schoolinfo eval 서울 강남구 고등학교 ○○고등학교
📋 ○○고등학교 평가계획 파일 12개 (과목별):
- 2026_국어과_평가계획.pdf (320KB)
- 2026_수학과_평가계획.pdf (280KB)
...
전체를 보려면 명령 끝에 'all'을 붙이세요. 예: eval 서울 강남구 고등학교 ○○고등학교 all
schoolinfo digest 서울 강남구 중학교 개포중학교 # 핵심 공시 모아보기
schoolinfo report 서울 강남구 중학교 # 학교 비교 리포트 (학급당·급식·교원기간제·동아리)
schoolinfo report 서울 강남구 중학교 개포중 대청중 # 특정 학교들만 비교
schoolinfo achievement 서울 강남구 중학교 개포중학교 # 교과별 학업성취(과목별 평균·성취도) 확인 링크 (캡차 보호, 중·고)
schoolinfo exams 서울 강남구 중학교 # 지역 시험 캘린더 (인근 학교 전체, NEIS)
schoolinfo exams 서울 강남구 중학교 개포중 대청중 # 특정 학교들 시험만
schoolinfo schedule 서울 강남구 중학교 개포중학교 # 학사일정 (시험·방학 등, NEIS_API_KEY 필요)
schoolinfo meal 서울 강남구 중학교 개포중학교 우유 땅콩 # 오늘 급식 (뒤에 회피 알레르기 나열, NEIS)
schoolinfo week 서울 강남구 중학교 개포중학교 2 3 # 이번주 브리핑 (급식·일정·D-day, 학년·반 주면 시간표, NEIS)
schoolinfo parse "C:\Downloads\2026_평가계획.hwp" # 받은 hwp → 마크다운 + 수행평가 추출
schoolinfo check 서울 강남구 중학교 개포중학교 # 변경 감지 + 알림 (스케줄러용)
비개발자도 OS 스케줄러로 주기 실행하면 됩니다. 공시가 바뀔 때만 알림이 뜹니다.
Windows 작업 스케줄러 — 매일 오전 8시 변경 확인:
schtasks /create /tn "학교알리미체크" /sc daily /st 08:00 ^
/tr "node C:\github_project\schoolinfo-mcp\dist\cli.js check 서울 강남구 중학교 개포중학교"
macOS/Linux cron — 매주 월요일 8시:
0 8 * * 1 SCHOOLINFO_API_KEY=... node /path/dist/cli.js check 서울 강남구 중학교 개포중학교
공식 웹앱은 school.gomdori.app — Vercel에 배포돼 있습니다. 레포에 vercel.json이 포함돼 본인 Vercel 계정에도 띄울 수 있습니다:
vercel link # 프로젝트 연결
echo "발급키" | vercel env add SCHOOLINFO_API_KEY production
echo "NEIS키" | vercel env add NEIS_API_KEY production # 학사일정용(선택)
vercel build --prod && vercel deploy --prebuilt --prod # 로컬 빌드 후 업로드
이 패키지는 npm 라이브러리(
main)를 겸하므로, Vercel이 라이브러리 진입점을 서버 함수로 오인하지 않도록vercel.json에서framework: null+api/index.ts단일 함수로 고정하고,vercel build → deploy --prebuilt로 로컬 빌드 산출물을 업로드합니다.
hwp/hwpx/pdf 파싱은 순수 JS(Chromium 불필요)라 서버리스 함수로 충분합니다. fly.io 등 일반 Node 호스트에는 node dist/server.js로도 그대로 띄울 수 있습니다(같은 handleRequest 공용).
공식 원격 MCP(
mcp.gomdori.app/school)는 이 레포가 아니라 통합 호스트gomdori-mcp(fly 머신 1대에 MCP 5종 동거, 비공개 레포)가 서빙합니다 — GitHub main을 커밋 SHA로 고정해 빌드하므로, 반영하려면 통합 호스트의 핀을 갱신하고 배포해야 합니다.
학교알리미 OpenAPI ─┐
(35종 정형 JSON) ├─→ SchoolInfoClient ─→ MCP 도구 / CLI / 웹앱
│
평가계획·편제 첨부 ─┤─→ kordoc(parse) ─→ 수행평가 표 / 교과 편제표 추출
│
NEIS 개방포털 ──────┘─→ 학사일정·급식·시간표
Content-Disposition RFC5987 인코딩(헤더 인젝션 차단)parse_evaluation_file) 비노출코드는 MIT(LICENSE). 데이터에는 MIT가 적용되지 않습니다.
src/admission.json 은 대학별 권장과목 안내 자료의 기재 내용을 원문에 가깝게 옮긴
것입니다. 이 저장소의 MIT 라이선스는 해당 데이터에 적용되지 않으며, 권리는 원 발간
기관에 있습니다. 재사용하려면 원 자료의 이용 조건을 직접 확인하세요. 입시 판단에는
반드시 각 대학의 최신 공식 발표를 확인해야 합니다.
전체 고지는 NOTICE를 참조하세요.
이 도구는 개인이 만든 비공식 프로젝트이며, 학교알리미·NEIS·한국대학교육협의회 등 어떤 기관과도 제휴·후원 관계가 없습니다. 서비스명 「우리 학교 알리미」는 공적 서비스 「학교알리미」와 무관합니다.
학교알리미 공시정보 MCP 서버 + CLI — 학부모가 내 아이 학교의 급식·학생수·수행평가 계획을 쉽게 확인 (OpenAPI + kordoc hwp 파싱)
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Schoolinfo ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-05 학교알리미 공시정보 MCP 서버 + CLI — 학부모가 내 아이 학교의 급식·학생수·수행평가 계획을 쉽게 확인 (OpenAPI + kordoc hwp 파싱)