🏗 22B Labs · 건설기술 오픈소스

국가건설기준, 이제 AI에게 바로 물어보세요

KCSC MCP — 국가건설기준(KCS/KDS)을 Claude·Codex 대화창에서 바로 검색하는 MCP 서버 무료 공개

📅 2026년 4월 ✍️ 22B Labs ⏱ 읽기 약 4분

건설 설계나 시공 검토를 하다 보면 KCS·KDS 기준을 수시로 확인해야 합니다. 브라우저를 열고, 국가건설기준센터에 접속하고, 키워드를 바꿔가며 검색하고, 페이지를 넘겨 해당 조항을 찾는 과정이 반복됩니다. 문서를 찾는 데 시간을 쓰고, 정작 검토에 집중할 시간이 줄어듭니다.

KCSC MCP는 그 과정을 없앱니다. Claude Desktop·Claude Code·Codex에 연결하면 "콘크리트 공사 KCS 기준에서 거푸집 관련 조항 찾아줘"라고 말하는 것만으로 국가건설기준센터 OpenAPI를 통해 결과가 바로 나옵니다.

"브라우저를 열고, 키워드를 바꾸고, 페이지를 넘기는 대신
AI에게 물어보세요."

who is this for

이런 분들에게 필요합니다

대상	활용 예시
건설 엔지니어	설계 검토 중 KDS 기준 조항 즉시 확인
시공 관리자	KCS 시공 기준 본문을 AI 대화 안에서 바로 조회
건축사·감리원	관련 기준 문서를 키워드로 빠르게 검색
공무원	사업 기획 시 적용 기준 확인
학생·연구자	건설기준 학습 및 조항 검색

tools

4개 MCP 도구

TOOL 01

kcsc_list_codes

KCS/KDS 코드 목록 조회. 타입·키워드·페이지네이션 필터 지원.

TOOL 02

kcsc_search_codes

코드명 기반 빠른 검색. 관련 문서 후보를 빠르게 좁힐 때.

TOOL 03

kcsc_get_content

특정 문서 전체 본문 조회. HTML 제거 옵션(plain_text=True) 지원.

TOOL 04

kcsc_search_sections

문서 내부 제목·본문 키워드 검색. 전체를 읽지 않고 필요한 조항만.

recommended workflow

실제 사용 예시

예시 1 — 콘크리트 관련 KCS 기준 찾기

말하기: "콘크리트 관련 KCS 기준을 찾아줘"
도구: kcsc_search_codes(keyword="콘크리트", code_type="KCS")

결과: KCS 114010 콘크리트 공사 일반 / KCS 114020 콘크리트 배합 / KCS 114030 콘크리트 타설 등

예시 2 — 문서 내 특정 조항 검색

말하기: "콘크리트 공사 일반에서 거푸집 관련 내용 찾아줘"
도구: kcsc_search_sections(code_type="KCS", code="114010", keyword="거푸집")

결과: 전체 본문을 읽지 않고 거푸집 관련 제목·단락만 추출

예시 3 — 도로 KDS 기준 목록 조회

말하기: "도로 관련 KDS 기준 목록 보여줘"
도구: kcsc_list_codes(code_type="KDS", keyword="도로", limit=20)

installation

설치 방법

📌 사전 준비 — KCSC OpenAPI 키가 필요합니다. kcsc.re.kr/support/api에서 무료로 발급받으세요.

# 1. 저장소 클론
git clone https://github.com/sinmb79/KCSC-MCP.git
cd KCSC-MCP

# 2. 가상환경 + 설치
python -m venv .venv
.venv\Scripts\activate    # Windows
source .venv/bin/activate  # macOS/Linux
pip install -e ".[dev]"

# 3. API 키 설정
copy .env.example .env
# .env 파일에 KCSC_API_KEY=발급받은키 입력

# 4. 서버 실행
python server.py
    

💡 Claude Desktop 연결 — claude_desktop_config.json에 추가:

{ "mcpServers": { "kcsc": { "command": "python.exe 경로", "args": ["server.py 경로"], "env": { "KCSC_API_KEY": "키" } } } }

💡 Codex / Claude Code
codex mcp add kcsc -- python server.py
claude mcp add --transport stdio kcsc -- python server.py

faq

자주 묻는 질문

Q. API 키를 넣었는데 동작하지 않아요.

키 만료 여부 확인 → .env 파일이 프로젝트 루트에 있는지 확인 → Claude Desktop 설정의 env 필드에도 키를 넣었는지 확인하세요.

Q. SSL 인증서 오류가 나요.

사내망이라면 KCSC_CA_BUNDLE에 사내 CA 번들 경로를 지정하세요. 최후 수단으로만 KCSC_VERIFY_SSL=false를 사용하세요.

Q. code와 fullCode가 헷갈려요.

둘 다 입력 가능합니다. 서버가 자동으로 변환합니다. code는 6자리, fullCode는 10자리입니다.

Q. 결과가 너무 많이 나와요.

kcsc_search_codes로 먼저 후보를 좁힌 뒤, kcsc_search_sections로 문서 내부 조항을 찾는 순서를 추천합니다. 처음부터 전체 본문을 열지 마세요.

GitHub에서 바로 시작하세요

MIT 라이선스 · 완전 무료 · 4개 MCP 도구
Python 3.11+ · Claude Desktop / Claude Code / Codex 지원
KCSC OpenAPI 키 필요 (무료 발급)

🔗 GitHub 바로가기

22B Labs · The 4th Path GitHub: sinmb79 · the4thpath.com
The 4th Path: ⟨H⊕A⟩ ↦ Ω

국가건설기준, 이제 AI에게 바로 물어보세요 KCSC MCP — 국가건설기준(KCS/KDS)을 Claude·Codex 대화창에서 바로 검색하는 MCP 서버 무료 공개