power-plan-db

한국 정부의 전력·에너지 법정 기본계획(전력수급기본계획·국가 탄소중립 녹색성장 기본계획·분산에너지 활성화·지능형전력망·집단에너지·신재생에너지·국가기간 전력망 확충·장기 송변전설비계획 등)을 공표 채널에서 자동 수집·파싱하고, MCP 서버로 AI 에이전트(Claude 등)에 제공하는 도구.

Collectors + parser + a thin MCP server for Korean government power/energy statutory plans. No API key required (public sources). Small corpus → plain full-text search, no vector DB. Bring-your-own-data: run the collectors to build your own local corpus.

무엇을 하나

• 수집(collect_power_plans.py) — no-agent, stdlib only, 무키.
  • korea.kr 정책브리핑 보도자료 검색(부처 발표분) + KEPCO 게시판(장기 송변전설비계획).
  • 계획별 키워드 + 제목 AND-필터, 신규분만 dedup, 첨부 PDF/HWP를 raw/<계획>/에 저장.
• 파싱(parse_plans.py) — raw/의 PDF → parsed/<계획>/*.md (markitdown, 멱등).
• 서빙(power_plans_mcp.py) — thin MCP 서버. 도구 3개: list_plans / search_plans / get_plan. 검색·문서제공만; 종합·분석은 호출하는 에이전트가.

설치

git clone <this-repo> && cd power-plan-db
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

사용

# 1) 수집 (최근 N일, 무키). --dry-run으로 먼저 확인, --selftest로 필터 점검
.venv/bin/python scripts/collect_power_plans.py --days 400
.venv/bin/python scripts/collect_power_plans.py --dry-run

# 2) 파싱 (PDF → markdown, 멱등)
.venv/bin/python scripts/parse_plans.py

# 3) MCP 서버 — 기본 stdio (아래 클라이언트 등록 참조)
.venv/bin/python scripts/power_plans_mcp.py

데이터 위치는 기본이 repo 루트(raw/·parsed/). 다른 곳에 두려면 POWER_PLAN_DB_DIR 지정(.env.example 참조).

MCP 클라이언트 등록

Claude Code:

claude mcp add power-plans -s user -e POWER_PLANS_MCP_TRANSPORT=stdio \
  -- /abs/path/.venv/bin/python /abs/path/scripts/power_plans_mcp.py

Claude Desktop (claude_desktop_config.json의 mcpServers):

"power-plans": {
  "command": "/abs/path/.venv/bin/python",
  "args": ["/abs/path/scripts/power_plans_mcp.py"],
  "env": { "POWER_PLANS_MCP_TRANSPORT": "stdio" }
}

LAN 자체호스팅(SSE) — 한 대에서 서버를 띄우고 같은 네트워크의 여러 사람이 붙기:

POWER_PLANS_MCP_TRANSPORT=sse POWER_PLANS_MCP_PORT=8766 .venv/bin/python scripts/power_plans_mcp.py
# 클라이언트는 http://<서버-LAN-IP>:8766/sse 로 커스텀 커넥터 추가

데이터는 포함하지 않습니다

계획 원문(PDF)·파싱본은 repo에 넣지 않습니다(.gitignore). 수집기를 돌려 각자 최신 코퍼스를 직접 생성하세요. 대상은 한국 정부가 공표한 공개 자료입니다(대체로 공공누리). 스크레이핑은 각 사이트 이용약관·robots를 확인하고, 스크립트의 요청 간격(sleep)을 유지해 정중하게 사용하세요.

한계

• RSS가 사문화(2026)돼 검색 페이지 HTML을 스크랩 → 사이트 구조 변경 시 셀렉터 조정 필요.
• 국가 탄소중립·지능형전력망 기본계획은 위원회(탄녹위) 발표라 korea.kr 보도자료에 없음 → 별도 확보.
• 표 레이아웃(공백 정렬 PDF)은 파싱 시 다소 깨질 수 있음(본문·수치는 정상).
• 근거법령·차수·수치를 실제 인용할 때는 원본과 교차확인하세요(이 도구는 검색·제공 도구입니다).

라이선스

MIT — LICENSE 참조.