Korean Bill & Debate MCP

대한민국 국회를 질문으로 탐색하고, 공식 기록으로 검증하세요.

법안의 발의부터 현재 상태, 위원회·소위원회 심사, 전문위원 검토, 의원과 정부의 실제 발언까지. 흩어진 국회 기록을 하나의 조사 흐름으로 연결합니다.

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

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

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

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

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

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

• 지금 어디까지 왔나 — 최신 의안 상태와 위원회·소위원회 심사 단계

• 왜 멈췄고 무엇이 쟁점인가 — 소위 회의록과 전문위원 검토보고서

• 누가 무엇을 말했나 — 의원·정부의 실제 발언과 바로 앞뒤 질의·답변

• 무엇으로 확인하나 — 공식 의안·회의록 URL과 원문 위치

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

Related MCP server: Korean Law MCP

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

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

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

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

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

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

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

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

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

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

• 조문별 찬반, 수정안과 대안

• 소관 부처의 답변과 수용 여부

• 보류·계속심사·대안반영에 이르는 협상 맥락

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

• 법체계 정합성과 다른 법률과의 충돌

• 집행 가능성, 비용, 예상되는 부작용

• 위원들이 심사할 핵심 쟁점과 수정 필요사항

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

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

무엇이 다른가

• 실시간 우선 — 준비된 과거 스냅샷에만 의존하지 않고 질문할 때 공식 의안·상태 API를 다시 확인합니다.

• 문서가 아닌 관계를 검색 — 법안, 회의, 사람, 발언, 질문과 답변을 연결해 같은 쟁점의 흐름을 복원합니다.

• 발언을 잘라내지 않음 — 한 문장만 보여주지 않고 바로 앞 질문, 정부 답변, 후속질의까지 함께 제공합니다.

• 검증 가능한 결과 — 모든 인용에 공식 URL과 원문 위치를 붙여 사용자가 직접 재확인할 수 있습니다.

• 사용자 통제형 데이터 — 자신의 열린국회 API 키와 로컬 캐시를 사용하며, 준비된 국회 전체 DB를 내려받거나 운영자의 공용 키를 공유하지 않습니다.

준비: 열린국회 API 키

사용자는 열린국회정보 Open API에서 본인의 인증키를 발급받아야 합니다. 키는 사용자의 컴퓨터에만 저장하며 저장소, 로그, 검색 결과에 포함하지 않습니다.

빠른 설치

uv와 PDF 텍스트 추출 도구가 필요합니다.

# macOS
brew install uv poppler

# Ubuntu/Debian
sudo apt-get install poppler-utils
curl -LsSf https://astral.sh/uv/install.sh | sh

설정 마법사는 키를 가려서 입력받고, 실제 열린국회 요청으로 검증한 뒤 선택한 클라이언트에 MCP를 등록합니다.

uvx korean-bill-debate-mcp setup --client claude-code
uvx korean-bill-debate-mcp setup --client codex
uvx korean-bill-debate-mcp setup --client gemini
uvx korean-bill-debate-mcp setup --client claude-desktop

키는 기본적으로 다음 파일에 사용자 전용 권한(0600)으로 저장됩니다.

~/.config/korean-bill-debate-mcp/credentials.env

수동 MCP 설정

환경변수로 직접 전달할 수도 있습니다.

{
  "mcpServers": {
    "korean-bill-debate": {
      "command": "uvx",
      "args": ["korean-bill-debate-mcp", "mcp"],
      "env": {
        "ASSEMBLY_OPEN_API_KEY": "본인의_열린국회_키"
      }
    }
  }
}

Claude Code와 Codex CLI의 상세 명령, Claude Desktop 및 웹 클라이언트 연결 방식은 MCP 연결 가이드를 참고하세요.

MCP 도구

캐시는 보조 수단입니다

전체 국회 DB나 준비된 검색 인덱스를 배포하지 않습니다. SQLite 캐시는 사용자가 이미 조회한 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 다운로드와 파싱 때문에 느릴 수 있으며, 이후 같은 자료는 로컬 캐시를 재사용합니다.