Skip to main content
Glama
Korean Assembly MCP

Korean Assembly MCP

by mhwan

korean-assembly-mcp

국회 공개 데이터를 Claude 같은 MCP 클라이언트에서 바로 조회하는 stdio MCP 서버입니다. 의원·법안·표결·일정·회의록 발언·국정감사 보고서·소속기관 발간물을 찾고, 중계 중인 회의의 AI 자막을 녹화해 회의록이 나오기 전에도 발언을 정리할 수 있습니다.

  • 도구 17개, 요약 프롬프트 3개

  • 제22대 국회 기준

  • 한 번 가져온 회의록·자막·보고서 본문은 로컬 SQLite 색인에 쌓여 날짜와 상관없이 다시 검색됩니다

데이터 원천

원천

쓰는 곳

열린국회정보 OpenAPI (open.assembly.go.kr)

의원, 법안, 표결, 일정, 회의록 목록, 발언영상, 국감 보고서, 발간물

국회회의록 시스템 (record.assembly.go.kr)

회의록 전문(의원별 발언 원문)

의안정보시스템 (likms.assembly.go.kr)

의안 첨부 문서(검토보고서·심사보고서 등)

국회 의사중계 (assembly.webcast.go.kr)

중계 목록, AI 자막 WebSocket

국회도서관 발언 데이터 (dataset.nanet.go.kr)

가져온 적 없는 회의까지 찾는 원격 전문 검색

국회 사이트들은 curl 같은 비브라우저 요청에 400을 돌려줍니다. 그래서 이 서버는 시스템 Chrome을 헤드리스로 띄우고, 대상 사이트 페이지 안에서 fetch 해 응답을 받습니다. User-Agent는 바꾸지 않습니다.

Related MCP server: open-assembly-mcp

요구 사항

항목

용도

비고

Node.js

서버 실행

내장 node:sqlite·WebSocket 을 씁니다. v26.12.1 에서 확인했습니다. node:sqlite 를 플래그 없이 쓰려면 22.13 이상이 필요하지만, 그 버전에서는 돌려 보지 않았습니다

Google Chrome

국회 사이트 호출

설치된 Chrome 을 OS별 기본 위치에서 찾아 씁니다(브라우저를 따로 받지 않음)

pdftotext (poppler)

검토보고서·국감 보고서 PDF 본문 추출

없어도 서버는 돌고, assembly_bill_reports·assembly_audit_reports 의 본문 읽기만 실패합니다

열린국회정보 인증키

OpenAPI 호출

아래 "인증키" 참고

지원 OS

OS

상태

macOS (Apple Silicon)

테스트로 확인

macOS (Intel), Windows, Linux

경로와 프로세스 처리는 OS별로 맞춰 두었지만 실제로 돌려 보지는 않았습니다

Chrome 은 다음 위치에서 찾습니다. 다른 곳에 있으면 ASSEMBLY_CHROME 에 실행 파일 경로를 넣습니다.

  • macOS: /Applications/Google Chrome.app

  • Windows: %LOCALAPPDATA%, %ProgramFiles%, %ProgramFiles(x86)% 아래 Google\Chrome\Application\chrome.exe

  • Linux: /opt/google/chrome/chrome (Google 이 배포하는 패키지 기준. 배포판 저장소의 Chromium 은 ASSEMBLY_CHROME 으로 지정)

설치

git clone https://github.com/mhwan/korean-assembly-mcp.git
cd korean-assembly-mcp
npm ci

pdftotext

macOS:

brew install poppler

Ubuntu·Debian:

sudo apt install poppler-utils

Windows: Scoop 을 쓰면 아래 명령으로 pdftotext.exe 가 PATH 에 들어갑니다. Scoop 없이 하려면 poppler-windows 릴리스 zip 을 풀고 Library\bin 폴더를 PATH 에 넣거나, ASSEMBLY_PDFTOTEXT 에 pdftotext.exe 경로를 넣습니다.

scoop install poppler

PATH 를 바꿨다면 MCP 클라이언트를 다시 시작해야 반영됩니다.

인증키

열린국회정보에 로그인한 뒤 "인증키 발급" 메뉴에서 받습니다. 키 없이도 응답은 오지만, 이 경우 받을 수 있는 행 수가 제한되는지는 확인하지 않았습니다.

키는 둘 중 한 곳에 둡니다. 환경 변수가 우선입니다.

  1. 환경 변수 ASSEMBLY_API_KEY

  2. 파일 ~/.config/assembly-data/credentials

mkdir -p ~/.config/assembly-data
printf 'ASSEMBLY_API_KEY=발급받은키\n' > ~/.config/assembly-data/credentials
chmod 600 ~/.config/assembly-data/credentials

Windows(PowerShell)에서는 같은 파일을 C:\Users\<이름>\.config\assembly-data\credentials 에 만듭니다.

New-Item -ItemType Directory -Force "$HOME\.config\assembly-data"
Set-Content -Path "$HOME\.config\assembly-data\credentials" -Value "ASSEMBLY_API_KEY=발급받은키" -Encoding ascii

> 나 Out-File 로 만들면 Windows PowerShell 5.1 에서는 UTF-16 으로 저장돼 키를 읽지 못하니 Set-Content 를 씁니다.

MCP 클라이언트에 등록

GUI 앱은 셸의 PATH 를 물려받지 않을 수 있으니 node 는 절대 경로로 적습니다. macOS·Linux 는 which node, Windows 는 where.exe node 로 확인합니다.

Claude Code

macOS·Linux(아래는 Homebrew 의 node 경로입니다. which node 결과로 바꿉니다):

claude mcp add --scope user assembly -- /opt/homebrew/bin/node /절대경로/korean-assembly-mcp/src/server.js

Windows:

claude mcp add --scope user assembly -- "C:\Program Files\nodejs\node.exe" C:\절대경로\korean-assembly-mcp\src\server.js

Claude Desktop

설정 파일 위치:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS:

{
  "mcpServers": {
    "assembly": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/절대경로/korean-assembly-mcp/src/server.js"]
    }
  }
}

Windows(JSON 안에서는 \ 를 \\ 로 적습니다):

{
  "mcpServers": {
    "assembly": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\절대경로\\korean-assembly-mcp\\src\\server.js"]
    }
  }
}

인증키를 파일 대신 환경 변수로 넘기려면 "env": { "ASSEMBLY_API_KEY": "..." } 를 더합니다.

다른 MCP 클라이언트도 명령은 node, 인자는 server.js 의 절대 경로 하나로 등록하면 됩니다.

등록한 뒤 클라이언트를 다시 시작해야 도구가 보입니다.

도구

회의록·발언

도구

하는 일

주요 인자

assembly_committee_meetings

기간 안의 위원회 회의록·국감 회의록 목록. 회의번호(confer_num)와 안건을 줍니다

from, to(최대 62일), committee

assembly_meeting_speeches

회의록 전문을 의원별로 묶은 발언 원문. 정당·지역구 포함, 특정 의원을 고르면 장관·증인 답변도 붙습니다

confer_num, members, max_chars_per_member, with_replies, include_chair

assembly_speech_clips

의원 발언영상 목록. 누가 몇 번, 몇 분 질의했는지 줍니다. member 를 주면 그 의원의 영상 구간과 링크도 나옵니다(원문 없음)

date, title, member

assembly_live

지금 의사중계 목록

only_live

assembly_live_captions_record

AI 자막 녹화 시작·상태 확인. 인자 없이 부르면 상태만 봅니다

xcode, all

assembly_live_captions

녹화한 자막을 질의 의원 블록으로 묶어 줍니다(화자는 추정값)

date, committee, member, from·to(HH:MM)

의원·법안·표결

도구

하는 일

주요 인자

assembly_members

의원 인적사항(정당·지역구·소속위원회·당선횟수·연락처). 조건 없으면 전원

name, party, committee, district

assembly_bills

법률안 검색, 제안일 최신순. 기본은 의원 발의안

name, proposer, proposer_kind(의원·위원장·정부), committee, result, from, to, limit

assembly_bill_detail

단계별 일자·결과, 제안이유, 제안자, 위원회 심사 회의, 대안과 원안 관계

bill_id 또는 bill_no

assembly_bill_reports

의안 첨부 문서 목록과 고른 문서의 본문(기본 검토보고서)

bill_id·bill_no, doc, offset, max_chars

assembly_votes

본회의 표결: 찬반 집계, 정당별·의원별 표결

bill_id, member, party

국감·발간물·일정

도구

하는 일

주요 인자

assembly_audit_reports

국정감사 결과보고서(2000~)와 정부 처리결과보고서(2001~2015년도분). 목록 또는 본문, 본문 안 검색

kind, year, query, doc_id, section, find, offset

assembly_publications

법제실·입법조사처·예산정책처·미래연구원·국회도서관 발간물 검색

query, source, div, from, to

assembly_schedule

본회의·위원회·국회행사·세미나 일정

date(YYYY-MM-DD, YYYY-MM, YYYY), kind, committee

검색·범용

도구

하는 일

주요 인자

assembly_search

로컬 색인 전문 검색. 로컬에 없으면 국회도서관 원격 검색

query, sources, from, to, committee, speaker, remote

assembly_index

색인 상태 확인, 기간 회의록 일괄 색인, 자막 녹화 색인

action(status·meetings·captions), from, to, committee, force, date

assembly_openapi

열린국회정보 OpenAPI 범용 호출. 쓸 수 있는 서비스 ID와 요청 변수는 도구 설명에 나옵니다

service, params, page, size

검색어 규칙(assembly_search): 띄어쓰기는 무시하고(전세사기 = 전세 사기), 공백으로 나눈 낱말은 모두 들어 있어야 하며, "따옴표" 로 묶으면 한 낱말로 봅니다. 원격 검색은 형태소 검색이라 낱말이 나뉘어 걸린 결과가 섞일 수 있습니다.

프롬프트

프롬프트

하는 일

인자

summarize_committee_speeches

회의 하나를 의원별 질의 요지·답변·해시태그로 정리

confer_num, members

summarize_meeting

회의 하나를 개요·핵심 논의사항·안건 처리·주제 태그·참석자·분량으로 요약

confer_num, date, committee

summarize_live_captions

녹화한 당일 자막을 질의 의원별 요지로 정리

committee, date

사용 흐름

지난 회의를 의원별로 정리

  1. assembly_committee_meetings 로 날짜·위원회의 confer_num 을 찾습니다.

  2. summarize_committee_speeches 나 summarize_meeting 프롬프트에 그 번호를 넣습니다.

오늘 회의를 회의록 공개 전에 정리

  1. assembly_live 로 중계 목록과 xcode 를 봅니다.

  2. 회의가 끝나기 전에 assembly_live_captions_record 로 녹화를 겁니다. 자막 서버는 접속한 뒤의 문장만 보내므로, 지난 구간은 다시 받을 수 없습니다.

  3. summarize_live_captions 프롬프트나 assembly_live_captions 로 정리합니다.

법안 하나를 끝까지 따라가기

assembly_bills → assembly_bill_detail → assembly_bill_reports(검토보고서) → assembly_votes

대안반영폐기된 법안은 assembly_bill_detail 이 붙여 주는 대안의 bill_id 로 표결을 찾습니다.

데이터 공개 시점

데이터

언제 볼 수 있나

도구

AI 자막

중계 중에만. 녹화해 둔 것만 남습니다

assembly_live_captions

발언영상 목록

회의 당일 저녁~다음 날

assembly_speech_clips

회의록 전문

회의 후 약 1주(국감은 목록만 먼저 뜨고 전문은 늦게 열림)

assembly_meeting_speeches

국회도서관 발언 데이터

회의 후 약 2주

assembly_search(원격)

공개 시점은 2026년 10월에 관찰한 값이라 달라질 수 있습니다.

환경 변수와 로컬 저장 위치

변수

기본값

설명

ASSEMBLY_API_KEY

~/.config/assembly-data/credentials 에서 읽음

열린국회정보 인증키

ASSEMBLY_CHROME

OS별 기본 설치 위치("지원 OS" 참고)

Chrome 실행 파일

ASSEMBLY_PDFTOTEXT

/opt/homebrew/bin, /usr/local/bin 순으로 찾고, 없으면 PATH 의 pdftotext

pdftotext 실행 파일

ASSEMBLY_REPORT_DIR

~/.cache/assembly-mcp/reports

받은 PDF와 추출 텍스트 캐시

ASSEMBLY_CAPTION_DIR

~/.cache/assembly-mcp/captions

자막 녹화 파일(날짜별 폴더), 녹화기 로그

ASSEMBLY_INDEX_DB

~/.cache/assembly-mcp/index.db

로컬 검색 색인(SQLite FTS5)

ASSEMBLY_INDEX

(없음)

off 면 도구를 써도 색인에 저장하지 않습니다

~ 는 Windows 에서 사용자 폴더(C:\Users\<이름>)입니다. 캐시를 지우려면 ~/.cache/assembly-mcp 를 통째로 지우면 됩니다. 색인도 함께 사라집니다.

자막 녹화기를 따로 돌리기

assembly_live_captions_record 는 내부에서 녹화기를 별도 프로세스로 띄웁니다. 저장소 폴더에서 직접 돌릴 수도 있습니다.

node src/caption-recorder.js --all
node src/caption-recorder.js 63 25
  • --all: 지금·앞으로 중계되는 자막 방송을 모두 녹화합니다. 중계가 모두 끝나고 30분 지나면 멈춥니다.

  • xcode 지정: 그 방송만 녹화하고, 끝나고 5분 뒤 멈춥니다.

  • 어느 쪽이든 최대 16시간 뒤에는 멈춥니다. 같은 대상으로 두 번 띄우면 뒤의 것은 바로 끝납니다.

  • 로그: ~/.cache/assembly-mcp/captions/recorder.log

  • 녹화기가 강제 종료되거나 컴퓨터를 재시작한 뒤에 녹화기를 띄웠는데 "이미 녹화 중" 이 나오고 녹화가 되지 않으면, 남아 있는 잠금 파일 ~/.cache/assembly-mcp/captions/recorder-*.json 을 지우고 다시 띄웁니다. 잠금 파일에 적힌 PID 를 다른 프로세스가 이어받은 경우입니다.

테스트

두 테스트 모두 실제 국회 사이트에 접속하고, 캐시·색인은 임시 폴더를 씁니다. 저장소 폴더에서 실행합니다.

node test/smoke.js 2026-10-14 행정안전 2026-10-27

도구를 실제로 불러 회의록 원문·OpenAPI 원본과 대조합니다. 인자는 회의일, 위원회, 발언영상 날짜이고, 빼면 위 값을 씁니다(npm run smoke 와 같음).

node test/index.js 2026-10-28

로컬 색인과 통합 검색을 검증합니다(npm run test:index -- 2026-10-28 와 같음). 인자는 자막 녹화가 있는 날짜입니다. 그날 녹화가 없으면 자막 색인 항목은 FAIL 로 나옵니다.

개발용 스크립트

스크립트

하는 일

node scripts/dump-meta.js

사용하는 OpenAPI 명세(서비스 ID·요청 변수·출력 필드)를 받아 data/openapi-specs.json 을 다시 만듭니다

node scripts/sample.js <서비스ID> [KEY=VALUE ...] [--size=N]

OpenAPI 한 서비스를 불러 건수와 앞쪽 행을 출력합니다

node scripts/fetch.js <URL> [--chars=N]

URL 하나를 실브라우저로 받아 앞부분을 출력합니다(응답 구조 확인용)

파일 구조

src/
  server.js            MCP 서버: 도구·프롬프트 등록
  browser.js           헤드리스 Chrome 안에서 fetch
  openapi.js           열린국회정보 OpenAPI 호출·페이지 처리
  domains.js           법안·표결·일정·중계 목록
  members.js           의원 인적사항
  minutes.js           회의록 목록·전문 파싱, 발언영상
  reports.js           의안 첨부 문서, 국감 보고서, 발간물, PDF 텍스트 추출
  captions.js          자막 녹화 파일 관리, 화자 추정
  caption-recorder.js  자막 녹화기(별도 프로세스)
  search-index.js      로컬 SQLite FTS5 색인
  nanet.js             국회도서관 원격 검색
  search.js            로컬·원격 통합 검색
data/openapi-specs.json  OpenAPI 명세 덤프(서버 시작 때 읽음)
scripts/               개발용 스크립트
test/                  실사이트 대조 테스트

한계와 주의

  • 제22대 국회만 조회합니다. 대수는 코드에 22로 들어 있습니다.

  • 테스트는 Apple Silicon Mac 에서만 돌렸습니다. 다른 OS 는 "지원 OS" 를 참고하세요.

  • OpenAPI 외에 회의록 HTML, 의안정보시스템 HTML, 국회도서관 HTML, 중계 자막 WebSocket을 직접 읽습니다. 이 경로들은 공개 API가 아니어서 사이트가 바뀌면 깨질 수 있습니다.

  • 자막은 AI 음성인식이라 오인식이 있고, 화자는 위원장의 지명·자기소개 문장으로 추정한 값입니다. 공식 기록은 회의록입니다.

  • 공공기관 사이트이니 짧은 시간에 많은 요청을 보내지 마세요.

  • 국회와 관계없는 개인 프로젝트입니다. 데이터의 권리와 이용 조건은 각 제공 기관을 따릅니다.

라이선스

코드는 MIT 라이선스입니다. 이 서버로 받은 데이터에는 적용되지 않으며, 데이터는 각 제공 기관의 이용 조건을 따릅니다.

Available Tools

17 tools
assembly_audit_reportsA

국정감사 문서. kind=result 는 위원회별 국정감사 결과보고서(2000~, 감사 개요·기관별 질의 요지·시정 및 처리요구사항·증인 목록), kind=correction 은 시정 및 처리요구사항에 대한 정부 처리결과보고서(2001~2015년도 국감분만 있음). doc_id 없이 부르면 목록(최신순), doc_id 를 주면 PDF 본문 텍스트. section=corrections 는 결과보고서의 시정·처리요구 절부터 준다. find 는 띄어쓰기를 무시하고 본문에서 찾아 offset 과 앞뒤 문맥을 준다(의원 이름 찾기 등). 본문이 길면 next_offset 으로 이어 읽는다.

Inputs: find, kind, year, limit, +5 more.

assembly_bill_detailA

의안 상세: 단계별 일자·결과, 제안이유 및 주요내용, 제안자 목록(대표발의 먼저), 위원회 심사 회의. 위원장안(대안)이면 반영된 원안 목록(original_bills), 대안반영폐기된 의안이면 그 대안(alternative)을 붙인다. 표결은 대안의 bill_id 로 assembly_votes 를 부른다. 대안은 같은 위원회 위원장안 중 처리일이 같은 것에서 찾으므로 못 찾으면 alternative 가 안내 문장이다(그때는 assembly_bills proposer_kind=위원장 으로 찾는다).

Inputs: bill_id, bill_no.

assembly_bill_reportsA

의안 첨부 문서 목록(의안원문·검토보고서·심사보고서·체계자구검토보고서 등, PDF/HWP 링크)과 doc 으로 고른 문서의 본문 텍스트(PDF 추출). 검토보고서는 위원회 전문위원이 쓴 쟁점·찬반 분석이다. 본문이 길면 next_offset 으로 이어 읽는다. 대안(위원회안)은 검토·심사보고서가 원안들에 붙으므로 original_bills 의 의안번호로 다시 부른다.

Inputs: doc, offset, bill_id, bill_no, +1 more.

assembly_billsA

제22대 법률안 검색. 제안일 최신순. 기본은 의원 발의안만 찾는다. 위원장안(대안)·정부안은 proposer_kind 로 찾는다(proposer 가 "…위원장"이면 자동). total 은 기간(from·to)을 빼고 센 전체 건수다.

Inputs: to, from, name, limit, +4 more.

assembly_committee_meetingsA

위원회 회의록 목록(열린국회정보 위원회 회의록 + 국정감사 회의록). 날짜 범위의 회의를 회의번호(confer_num)별로 안건과 함께 돌려준다. 국감 회의록은 class 가 "국정감사 회의록"이고 안건이 비어 있다. 회의록은 회의 후 약 1주 뒤 공개되므로(국감은 목록만 먼저 뜨고 전문은 늦게 열린다) 최근 회의는 assembly_speech_clips 를 쓴다.

Inputs: from (required), to, committee.

assembly_indexA

로컬 검색 색인 관리. status: 출처별 문서·조각 수와 최근 색인 문서. meetings: 기간(최대 62일)·위원회의 공개된 회의록을 한꺼번에 색인(이미 있으면 건너뜀, force 면 다시). captions: 그날 자막 녹화를 색인. 회의록·자막·보고서 도구를 쓰면 자동으로도 색인된다.

Inputs: to, date, from, force, +3 more.

assembly_liveB

국회 의사중계 현재 중계 목록.

Inputs: only_live.

assembly_live_captionsA

녹화된 의사중계 AI 자막(STT)을 질의 의원 블록으로 묶어 준다. 블록마다 의원·정당·지역구와 transcript("[시각] (역할?) 문장")가 붙는다. 회의록이 나오기 전 당일 발언 원문용. 화자는 위원장 지명·자기소개 문장으로 추정한 값이고 자막에는 인식 오류가 있다. 위원장이 부른 이름이 의원 명단에 없으면(STT 오인식) member 는 null, heard 는 자막에 들린 이름이다.

Inputs: to, date, from, xcode, +3 more.

assembly_live_captions_recordA

의사중계 AI 자막 녹화 시작/상태. 자막 서버는 접속 이후 문장만 보내므로 회의 전체를 보려면 중계 중에 미리 녹화해야 한다. 녹화기는 이 서버와 별도 프로세스로 돌고, 중계가 끝나면 스스로 멈춘다. xcode 는 assembly_live 의 xcode, all=true 면 모든 자막 중계를 녹화한다. 인자 없이 부르면 상태만 본다.

Inputs: all, xcode.

assembly_meeting_speechesA

회의록 전문(record.assembly.go.kr)을 의원별로 묶어 발언 원문을 돌려준다. 의원마다 정당·지역구와 transcript(차례별 "[안건N] 발언" 단락, 답변은 "↳ 답변자: …")가 붙는다. 분량이 크면 의원별 max_chars_per_member 로 잘린다(truncated=true). 특정 의원을 members 로 고르면 장관·증인 답변(replies)도 함께 준다.

Inputs: confer_num (required), members, with_replies, include_chair, +1 more.

assembly_membersB

제22대 국회의원 인적사항 검색(정당·지역구·소속위원회·당선횟수·연락처). 조건 없이 부르면 전원.

Inputs: name, party, district, committee.

assembly_openapiC

열린국회정보 OpenAPI 범용 호출. 아래 서비스ID와 요청 변수(*는 필수)를 쓴다.

  • nwvrqwxyaytdsfvhu 국회의원 인적사항: HG_NM, POLY_NM, ORIG_NM, CMITS, SEX_GBN_NM, MONA_CD

  • ALLNAMEMBER 국회의원 정보 통합 API: NAAS_CD, NAAS_NM, PLPT_NM, BLNG_CMIT_NM

  • nktulghcadyhmiqxi 위원회 위원 명단: DEPT_CD, DEPT_NM, JOB_RES_NM, HG_NM, ORIG_NM, POLY_NM, ASSEM_TEL, ASSEM_EMAIL, MONA_CD

  • nxrvzonlafugpqjuh 위원회 현황 정보: CMT_DIV_NM, HR_DEPT_CD, COMMITTEE_NAME, HG_NM, HG_NM_LIST

  • nuvypcdgahexhvrjt 국회의원 상임위 활동: DAE_NUM*, SES_NUM, DEGREE_NUM, COMM_NAME, CONF_DATE, CLASS_NAME

  • nzmimeepazxkubdpn 국회의원 발의법률안: BILL_ID, BILL_NO, BILL_NAME, COMMITTEE, PROC_RESULT, AGE*, PROPOSER, COMMITTEE_ID

  • ALLBILLV2 의안정보 통합 API: ERACO*, BILL_ID, BILL_NO, BILL_KND, BILL_NM, PPSR_KND, PPSL_DT, JRCMIT_NM, RGS_CONF_RSLT

  • BILLINFODETAIL 의안 상세정보: BILL_ID*

  • BILLINFOPPSR 의안 제안자정보: BILL_ID*

  • BILLRCPV2 의안 접수목록: ERACO, BILL_ID*

  • BPMBILLSUMMARY 법률안 제안이유 및 주요내용: BILL_NO*

  • TVBPMBILL11 법률안 심사 및 처리(의안검색): BILL_ID, BILL_NO, AGE*, BILL_NAME, PROPOSER, PROPOSER_KIND, CURR_COMMITTEE_ID, CURR_COMMITTEE, PROC_DT, PROC_RESULT_CD, BILL_ID_REF

  • BILLJUDGECONF 의안 위원회심사 회의정보 조회: BILL_ID*

  • BILLJUDGE 의안 심사정보(예ㆍ결산 제외): ERACO

  • TVBPMCONFINFO 소위 심사정보(법률안): AGE*, BILL_NO, BILL_ID, ENROLL_TYPE

  • nojepdqqaweusdfbi 국회의원 본회의 표결정보: HG_NM, POLY_NM, MEMBER_NO, VOTE_DATE, BILL_NO, BILL_NAME, BILL_ID*, CURR_COMMITTEE, RESULT_VOTE_MOD, CURR_COMMITTEE_ID, MONA_CD, AGE*

  • ncocpgfiaoituanbr 의안별 표결현황: BILL_ID, BILL_NO, BILL_NAME, CURR_COMMITTEE, CURR_COMMITTEE_ID, PROC_RESULT_CD, BILL_KIND_CD, AGE*

  • ncwgseseafwbuheph 위원회 회의록: TITLE, CLASS_NAME, DAE_NUM*, COMM_NAME, CONF_DATE*, SUB_NAME, DEPT_CD

  • VCONFDETAIL 회의록별 상세정보: CONF_ID*

  • VCONFBLLLIST 회의별 안건목록: CONF_ID*

  • WEBCASTVCONF 영상회의록 목록: ERACO, CONF_DT

  • npeslxqbanwkimebr 국회의원 영상회의록(발언영상): CT1*, TAKING_DATE*, TITLE, ESSENTIAL_PERSON

  • ALLSCHEDULE 국회일정 통합 API: SCH_KIND, SCH_DT

  • nrsldhjpaemrmolla 위원회별 일정: MEETING_DATE, MEETING_TIME, SESS, DEGREE, TITLE, COMMITTEE_NAME, UNIT_CD*, HR_DEPT_CD

  • nttmdfdcaakvibdar 위원회별 전체회의 일정: MEETING_DATE, MEETING_TIME, SESS, DEGREE, TITLE, COMMITTEE_NAME, UNIT_CD*, HR_DEPT_CD

  • nrkqqbvfanfybishu 위원회별 소위원회 일정: MEETING_DATE, MEETING_TIME, SESS, DEGREE, TITLE, COMMITTEE_NAME, UNIT_CD*, HR_DEPT_CD

  • napvpafracrdkxmoq 위원회별 공청회 일정: MEETING_DATE, MEETING_TIME, SESS, DEGREE, TITLE, COMMITTEE_NAME, UNIT_CD*, HR_DEPT_CD

  • nekcaiymatialqlxr 본회의 일정: MEETINGSESSION, CHA, TITLE, MEETTING_DATE, UNIT_CD*

  • NAMEMBEREVENT 의원실 행사 정보:

  • nfcoioopazrwmjrgs 국회의원 세미나 일정: TITLE, DESCRIPTION, SDATE, NAME, LOCATION

  • nbqbmccpamsvwebkn 국회의원 정책 세미나 개최 현황: TITLE, HOST_DT*, HOST_INS_NAME, ATTENDANCE_NAME1, ATTENDANCE_NAME2

  • npbzvuwvasdqldskm 국회의원 기자회견: TAKING_DATE*, TITLE, PERSON

  • ALLNASPBLM 국회발간물 통합 API: MTR_DIV, MTR_TTL

  • ALLNARSPBLM 국회입법조사처 제공 자료 통합 API: MTR_DIV, MTR_TTL

  • ALLNABOPBLM 국회예산정책처 제공 자료 통합 API: MTR_DIV, MTR_TTL

  • ALLNAFIPBLM 국회미래연구원 제공 자료 통합 API: MTR_DIV, MTR_TTL

  • ALLNANETPBLM 국회도서관 제공 자료 통합 API: MTR_DIV, MTR_TTL

Inputs: service (required), page, size, params.

assembly_publicationsA

국회 소속기관 발간물 검색(법제실·입법조사처·예산정책처·미래연구원·국회도서관). 제목·구분은 부분일치, 결과는 작성일 최신순. 입법조사처 "이슈와 논점"·예산정책처 "NABO Focus"·도서관 "최신외국입법정보" 같은 구분명은 div 로 거른다.

Inputs: to, div, from, limit, +2 more.

assembly_scheduleC

국회 일정 통합(본회의·위원회·국회행사·세미나).

Inputs: date (required), kind, committee.

assembly_speech_clipsA

국회의원 발언영상 목록(회의 당일 저녁~다음 날 공개). 회의별로 누가 몇 번, 몇 분 질의했는지 준다. 발언 원문은 없다. member 를 주면 그 의원의 영상 구간(답변자·길이·영상 링크)까지 준다. 국감 회의 제목엔 위원회명이 없고 피감기관만 있다.

Inputs: date (required), title, member.

assembly_votesC

본회의 표결: 의안별 찬반 집계와 정당별·의원별 표결.

Inputs: bill_id (required), party, member.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 17 tools

    Disambiguation4/5

    Tools are mostly distinct: bills, bill detail, reports, votes, meetings, speeches, clips, and captions each target a different resource or stage of the legislative workflow. The main ambiguity comes from assembly_openapi, a generic catch-all that overlaps with many specialized tools, and from the dense clustering of assembly_committee_meetings / assembly_meeting_speeches / assembly_speech_clips / assembly_live_captions, where the boundaries require careful reading.

    Naming Consistency5/5

    All tool names use a consistent assembly_ snake_case prefix with noun/action phrasing (assembly_bills, assembly_bill_detail, assembly_votes, assembly_schedule). Minor ordering differences like assembly_live_captions_record are still readable and fit the overall convention.

    Tool Count4/5

    At 17 tools the set is slightly above the ideal 3-15 range, but the breadth of the Assembly domain (members, bills, meetings, votes, reports, schedule, publications, live captions, search) justifies most tools. Each appears to earn its place rather than duplicating another.

    Completeness4/5

    Coverage is strong: members, bill lifecycle, bill detail, attachments, votes, meeting minutes, speeches, live captions, audit reports, publications, schedule, and search/index are all represented. Remaining gaps (e.g., committee rosters or member-level activity outside the generic OpenAPI passthrough) are minor and mostly workable via assembly_openapi.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access real-time legislative data from the Korean National Assembly including members, bills, votes, and schedules through 276 Open APIs. Supports dual transport modes (stdio/HTTP), configurable Lite/Full tool profiles, and in-memory caching for efficient querying.
      17 npm
      94
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the Korean National Assembly Open API, enabling querying of bills, members, votes, committees, and more via natural language.
      20
      51 PyPI
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Enables LLM clients to search and analyze bills, members, committees, meetings, votes, and reports from the South Korean National Assembly OpenAPI through MCP tools.
      26
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables search and retrieval of speech turns from Korea's National Assembly records using Korean or English natural-language queries, with citation-ready context and tools for exploring committees and meetings.
      5
      1
      Apache 2.0