Korean Bill & Debate MCP

흩어진 국회 기록을, 법안 하나로 연결했습니다.

법안 내용과 처리상태부터 소위원회 회의록, 전문위원 검토보고서, 의원과 정부의 실제 발언까지 하나의 조사 흐름으로 이어서 확인합니다.

v0.7.0 · 한국어 중심 · 사용자 본인의 열린국회 API 키 · 실시간 조회 · Apache-2.0

English · MCP 연결 · 데이터 출처 · 아키텍처

국회 정보는 공개돼 있습니다. 하지만 답은 흩어져 있습니다

의안 페이지에는 처리상태가 있고, 위원회 페이지에는 회의 정보가 있으며, 실제 쟁점은 PDF 회의록과 검토보고서 안에 묻혀 있습니다. 의원의 질문과 정부의 답변은 서로 떨어져 있고, 같은 사안을 다룬 여러 법안은 별개의 문서처럼 보입니다.

Korean Bill & Debate MCP는 이 기록들을 법안–심사–사람–발언–답변–근거의 관계로 연결합니다. 사용자는 사이트와 PDF를 오가며 문서를 맞추는 대신, 자연어로 질문하고 공식 원문까지 이어지는 조사 결과를 받을 수 있습니다.

한 질문에, 국회 조사의 네 축을 함께 답합니다

• 지금 어디까지 왔나 — 최신 의안 상태와 위원회·소위원회 심사 단계
• 왜 멈췄고 무엇이 쟁점인가 — 소위 회의록과 전문위원 검토보고서
• 누가 무엇을 말했나 — 의원·정부의 실제 발언과 바로 앞뒤 질의·답변
• 무엇으로 확인하나 — 공식 의안·회의록 URL과 원문 위치

문서를 나열하는 데서 끝나지 않습니다. 법안–회의–사람–발언–답변을 연결해, 다시 확인하고 인용할 수 있는 조사 결과로 돌려줍니다.

국회 안팎에서 입법을 만들고, 대응하고, 연구하는 사람들을 위해

같은 국회 기록도 업무에 따라 필요한 답은 다릅니다. 이 MCP는 입법을 만들고, 대응하고, 연구하는 사람들이 각자의 질문에서 바로 공식 근거로 들어갈 수 있게 합니다.

사용자	필요한 판단	바로 연결되는 근거
국회 직원·보좌진	심사 준비, 쟁점 정리, 질의 작성	유사 의안, 소위 회의록, 검토보고서, 부처 답변
기업 정책·법무·대관팀	규제 방향과 사업 영향, 대응 시점	최신 상태, 의원별 문제의식, 정부 수용 여부, 집행 쟁점
공공기관·협회	소관 법안 대응과 공식 의견 준비	관련 의안, 위원회 논의, 이해관계자 발언, 원문 인용
시민단체	입법 감시, 의견서·논평·캠페인	조문별 쟁점, 찬반 발언, 심사 경과, 공식 회의록
언론인	발언 검증, 쟁점 시계열, 팩트체크	실제 발언, 앞뒤 문맥, 날짜별 사건, 출처 위치
연구자	정책 변화와 담론의 장기·비교 분석	구조화된 법안·회의·발언 관계와 재현 가능한 인용

실제로 이렇게 물어볼 수 있습니다

[입법 심사] “이 법안과 같은 취지의 의안, 소위 쟁점, 전문위원 검토와 부처 답변을 정리해줘”
[기업 대응] “플랫폼 노동 규제 법안이 어디까지 왔고 기업에 영향을 줄 쟁점은 무엇이야?”
[시민사회] “피해자 보호 조항이 심사 과정에서 어떻게 바뀌었고 누가 어떤 의견을 냈어?”
[언론 취재] “보완수사권 폐지에 대한 상반된 발언을 앞뒤 맥락과 공식 원문으로 비교해줘”
[연구] “인공지능 정책 관련 법안과 위원회 논의를 시계열로 연결하고 반복되는 쟁점을 찾아줘”
[의안 추적] “2219564번 의안의 최신 처리상태와 연결된 회의록·검토자료 원문을 찾아줘”

검색 결과가 아니라, 조사 흐름을 돌려줍니다

MCP는 질문할 때 열린국회 공식 API를 조회합니다. 관련 의안과 처리상태에서 소관 위원회와 시점을 찾고, 필요한 공식 회의록만 내려받아 발언자·질의·답변·후속질의를 복원합니다.

자연어 질문
  → 공식 의안·처리상태 실시간 조회
  → 관련 전문위원 검토보고서 확인·검색
  → 관련 위원회·본회의·소위원회 후보 탐색
  → 필요한 회의록만 다운로드·파싱
  → 법안–회의–사람–발언–답변 연결
  → 공식 의안·회의록 URL과 원문 위치 반환

국회 경험자가 처리상태 다음에 보는 것

국회 경험이 있는 사람들은 법안의 다음 흐름을 볼 때 처리상태에서 멈추지 않습니다. 실제 협상이 기록된 소위원회 회의록과 심사 쟁점을 구조화한 전문위원 검토보고서를 함께 봅니다.

1. 소위원회 회의록 — 실제로 어디서 막혔는가

• 조문별 찬반, 수정안과 대안
• 소관 부처의 답변과 수용 여부
• 보류·계속심사·대안반영에 이르는 협상 맥락

2. 전문위원 검토보고서 — 무엇이 심사 쟁점이 되는가

• 법체계 정합성과 다른 법률과의 충돌
• 집행 가능성, 비용, 예상되는 부작용
• 위원들이 심사할 핵심 쟁점과 수정 필요사항

이 MCP는 법안의 미래를 임의로 단정하지 않습니다. 대신 향후 흐름을 판단할 수 있도록 의안 상태, 소위원회 회의록, 전문위원 검토보고서, 의원·정부 발언을 공식 원문 근거로 연결합니다.

검토보고서를 미리 대량 수집하지 않습니다. 사용자가 관련 법안을 질문할 때 공식 의안정보시스템에서 보고서 PDF를 확인하고 필요한 문서만 내려받아 검색합니다. 로컬 설치는 이를 개인 캐시에 보관해 같은 문서를 다시 다운로드하지 않습니다.

무엇이 다른가

• 실시간 우선 — 준비된 과거 스냅샷에만 의존하지 않고 질문할 때 공식 의안·상태 API를 다시 확인합니다.
• 문서가 아닌 관계를 검색 — 법안, 회의, 사람, 발언, 질문과 답변을 연결해 같은 쟁점의 흐름을 복원합니다.
• 발언을 잘라내지 않음 — 한 문장만 보여주지 않고 바로 앞 질문, 정부 답변, 후속질의까지 함께 제공합니다.
• 검증 가능한 결과 — 모든 인용에 공식 URL과 원문 위치를 붙여 사용자가 직접 재확인할 수 있습니다.
• 사용자 통제형 데이터 — 운영자의 공용 키를 공유하지 않고 각자 자신의 열린국회 API 키를 사용합니다. 로컬 설치는 개인 캐시를, 웹 연결은 원문 키를 저장하지 않는 개인 토큰을 사용합니다.

3분이면 사용하는 AI에 연결할 수 있습니다

이 MCP는 별도 프로그램을 배울 필요가 없습니다. 한 번 연결한 뒤 사용하는 AI에 평소처럼 질문하면 필요한 국회 공식 기록을 도구가 찾아옵니다.

방법 1: Claude.ai·ChatGPT 웹에서 바로 사용 — 설치 없음

먼저 열린국회정보 Open API에서 본인의 키를 발급받고 https://korean-bill-debate-mcp.vercel.app을 브라우저에서 엽니다.

1. 본인의 열린국회 API 키를 입력합니다.
2. 개인 MCP 링크 만들기를 누릅니다.
3. 완성된 https://.../mcp?token=... 주소 전체를 복사합니다.
4. 사용하는 웹 앱의 커스텀 MCP 서버 URL에 붙여 넣습니다.

Claude.ai

1. 설정 → 커넥터 → 커스텀 커넥터 추가로 이동합니다.
2. 이름은 Korean Bill & Debate, URL은 발급받은 개인 MCP 링크를 입력합니다.
3. 채팅의 + → 커넥터에서 활성화합니다.

ChatGPT

1. 설정 → 앱 → 고급 설정에서 개발자 모드를 활성화합니다.
2. 앱 만들기를 선택합니다.
3. 이름은 Korean Bill & Debate, 서버 URL은 발급받은 개인 MCP 링크를 입력합니다.
4. 만든 앱을 연결하고 채팅의 + 메뉴에서 선택합니다.

키 없는 /mcp 주소만 붙여 넣으면 연결되지 않습니다. 반드시 연결 페이지에서 본인의 키로 만든 개인 MCP 링크 전체를 사용하세요. 키 원문은 서버의 DB나 파일에 저장하지 않지만, 발급된 링크는 사용자의 API 할당량을 사용할 수 있으므로 비밀번호처럼 보관해야 합니다.

방법 2: Claude Desktop·Claude Code·Codex·Gemini CLI에 로컬 설치

1. 열린국회 API 키를 발급받고 uv와 Poppler를 설치합니다: macOS brew install uv poppler
2. 릴리스를 설치합니다.

uv tool install git+https://github.com/epoko77-ai/korean-bill-debate-mcp.git@v0.7.0

3. 사용하는 앱 하나만 골라 실행합니다.

kbd setup --client claude-desktop
kbd setup --client claude-code
kbd setup --client codex
kbd setup --client gemini

4. 앱을 다시 열고 질문합니다.

2219564번 의안의 내용과 최신 처리상태, 소위원회 회의록,
전문위원 검토보고서와 관련 의원·정부 발언을 공식 원문과 함께 연결해줘.

상세 화면 경로와 수동 설정은 **MCP 연결 가이드**를 참고하세요.

MCP 도구

도구	실시간 조사 내용
explore_issue	쟁점에서 법안·상태·검토보고서·회의·발언·앞뒤 문맥까지 한 번에 조사
search_bills	법안 검색 후 전문위원 검토보고서의 관련 대목과 공식 원문까지 연결
get_bill_status	공식 처리상태를 다시 확인하고 해당 법안의 검토보고서 문서 연결
search_speeches	관련 회의를 탐색하고 필요한 회의록을 수집한 뒤 발언 검색
get_speech	캐시에 저장된 발언 전문과 공식 출처 확인
get_speech_context	발언 전후 질의·답변·후속질의 복원
list_committees	공식 회의 메타데이터에서 위원회 확인
list_meetings	날짜·위원회·회의 종류로 공식 회의 탐색

캐시는 보조 수단입니다

전체 국회 DB나 준비된 검색 인덱스를 배포하지 않습니다. 로컬 설치의 SQLite 캐시는 사용자가 이미 조회한 API 응답, 회의록, 구조화 발언을 재사용해 반복 요청을 빠르게 합니다. 웹 연결의 캐시는 서버 인스턴스의 임시 공간만 사용하며 사용자 API 키 원문은 저장하지 않습니다.

• 새 질문은 공식 API에서 후보를 다시 탐색합니다.
• 법안 처리상태는 공식 상태 API를 우선합니다.
• API 캐시는 기본 15분 후 만료됩니다.
• 회의록 원문은 공식 URL과 SHA-256을 함께 보존합니다.
• 로컬 기본 캐시 위치는 ~/.local/share/korean-bill-debate-mcp입니다.
• KBD_DATA_DIR로 위치를 바꿀 수 있습니다.

개발

uv sync --extra dev
ASSEMBLY_OPEN_API_KEY=본인키 uv run kbd research "검찰 보완수사권 폐지"
uv run pytest
uv run ruff check .
uv run mypy src

fixture 테스트는 API 키 없이 실행됩니다. 실제 API smoke test는 저장소 Secret 또는 개발자의 환경변수를 사용하며, 키를 출력하지 않습니다.

범위와 검증 원칙

이 프로젝트는 공식 근거를 검색하고 연결하는 조사 도구입니다. 의원의 찬반 입장을 임의로 추정하지 않으며 실제 발언과 앞뒤 문맥을 제공합니다. 모든 인용은 citation.official_url과 source_locator로 원문을 확인해야 합니다.

열린국회 API가 검색 조건으로 제공하지 않는 자유어 전체 회의록 검색은 관련 법안·위원회· 시점을 먼저 좁힌 뒤 제한된 수의 회의록을 동적으로 분석합니다. 첫 조회는 PDF 다운로드와 파싱 때문에 느릴 수 있으며, 이후 같은 자료는 로컬 캐시를 재사용합니다.