AssemblyMCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AssemblyMCP verify bill PRC_SAMPLE status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AssemblyMCP
대한민국 국회 정보공개 OpenAPI를 MCP(Model Context Protocol) 도구로 제공하는 서버입니다. LLM 클라이언트가 의안, 의원, 위원회, 회의, 표결, 국회 보고서 데이터를 조회하고 검증형 워크플로로 조합할 수 있게 합니다.
먼저 호출할 도구
LLM 클라이언트는 세션 시작 시 get_legislative_research_kit()을 먼저 호출하는 것을 권장합니다.
이 도구는 공개 도구 목록, 네이밍 규칙, 권장 워크플로, 실패 마커 계약을 구조화 데이터로 반환합니다.
실패 마커는 다음 형태로 반환됩니다.
Marker | 의미 |
| 실제 조회했지만 일치 데이터가 없음 |
| 후보가 여러 개라 사용자가 식별자를 좁혀야 함 |
| 데이터는 찾았지만 기대 필드와 불일치 |
| 국회 API 또는 서버 호출 중 오류 |
| 복합 워크플로 일부 단계 실패, 나머지는 사용 가능 |
Related MCP server: Korean National Assembly MCP Server
워크플로 중심 도구
Tool | 목적 |
| 의안, 의원, 위원회, 표결 주장/인용을 국회 데이터로 검증 |
| 주제별 의안, 위원회, 회의, 보고서, 표결 신호를 통합 |
| 의안의 발의, 회부, 회의, 표결, 최종 처리 이벤트를 정규화 |
| 주제 또는 의안 중심 관계 그래프(nodes/edges/mermaid) 생성 |
| 지속 모니터링을 위한 후속 MCP 호출 계획 생성 |
검증 입력 예시
[
{"type": "bill", "value": "PRC_SAMPLE", "expected": {"status": "위원회 심사"}},
{"type": "member", "value": "홍길동"},
{"type": "committee", "value": "법제사법위원회"},
{"type": "vote", "bill_id": "PRC_SAMPLE", "expected": {"yes": 180}}
]JSON이 아닌 일반 텍스트를 넣으면 auto claim으로 처리되어 의안, 의원, 위원회 후보를 순차 확인합니다.
조회 및 분석 도구
Tool | 목적 |
| 키워드, 의안 ID, 발의자, 처리상태 등으로 의안 검색 |
| 의안 상세, 주요 내용, 제안 이유 조회 |
| 기존 호환용 의안 이력 타임라인 |
| 주제별 기존 종합 분석 |
| NABO 보고서와 국회 뉴스 검색 |
| 위원회별 계류 의안과 보고서 요약 |
| 국회의원 인적사항 검색 |
| 의원 기본 정보, 발의 법안, 위원회 경력, 표결 이력 통합 |
| 의안 또는 위원회 기준 회의 검색 |
| 본회의 일정 조회 |
| 위원회 목록, 위원회 상세, 위원 명단 조회 |
| 의안별 본회의 표결 결과와 정당별 샘플 경향 |
| 주제별 표결 경향 분석 |
| 의원 또는 의안 기준 개별 표결 기록 |
Raw API 탐색 도구
AssemblyMCP는 고수준 도구에 없는 데이터도 국회 OpenAPI 메타데이터를 통해 직접 탐색할 수 있습니다.
Tool | 목적 |
| 사용 가능한 국회 API 서비스 검색 |
| 서비스 파라미터, 응답 구조, 샘플 데이터 확인 |
| 특정 OpenAPI 서비스 직접 호출 |
|
|
| 서버 상태와 사용 가이드 확인 |
| 서버 생존 확인 |
권장 탐색 순서:
list_api_services(keyword) -> get_api_spec(service_id) -> call_api_raw(service_id, params)빠른 시작
1. API 키 발급
공공데이터포털(data.go.kr)에서 국회사무처 관련 API 활용 신청 후 인증키를 발급받습니다.
2. Claude Desktop 설정
Claude Desktop 설정 파일에 다음 항목을 추가합니다.
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"assembly": {
"command": "uvx",
"args": ["git+https://github.com/StatPan/AssemblyMCP"],
"env": {
"ASSEMBLY_API_KEY": "your_api_key_here"
}
}
}
}설정 후 Claude Desktop을 재시작합니다.
3. 로컬 실행
export ASSEMBLY_API_KEY="your_api_key_here"
uvx git+https://github.com/StatPan/AssemblyMCPStreamable HTTP 모드로 실행하려면:
export ASSEMBLY_API_KEY="your_api_key_here"
export MCP_TRANSPORT=http
export MCP_PORT=8000
export MCP_PATH=/mcp
uvx git+https://github.com/StatPan/AssemblyMCP개발
요구사항
Python 3.12 이상
설치 및 테스트
git clone https://github.com/StatPan/AssemblyMCP.git
cd AssemblyMCP
uv sync
export ASSEMBLY_API_KEY="your_api_key_here"
uv run assemblymcp품질 확인:
uv run ruff check .
uv run ruff format .
uv run pytest환경 변수
변수 | 설명 | 기본값 |
| 국회 OpenAPI 인증키 | 없음 |
| 로깅 레벨 |
|
| JSON 구조화 로깅 |
|
| 인메모리 캐싱 |
|
| 캐시 TTL |
|
| 최대 캐시 항목 수 |
|
|
|
|
| HTTP 바인드 호스트 |
|
| HTTP 포트 |
|
| HTTP MCP 경로 |
|
배포
Dockerfile이 포함되어 있으며 Cloud Run, Railway, Fly.io 등에 배포할 수 있습니다.
gcloud run deploy assembly-mcp \
--source . \
--region asia-northeast3 \
--allow-unauthenticated \
--set-env-vars ASSEMBLY_API_KEY="your_key",ASSEMBLY_LOG_JSON="true",ASSEMBLY_ENABLE_CACHING="true"HTTP 배포 시 MCP 엔드포인트 기본 경로는 /mcp입니다.
라이선스
MIT
Available Tools
26 toolsanalyze_legislative_issueA
특정 주제(이슈)에 대한 종합적인 입법 현황 분석 리포트를 생성합니다. 이 도구는 관련 법안 검색, 주요 법안의 상세 내용, 관련 위원회 회의록, 그리고 해당 주제를 주도하는 주요 국회의원 정보를 한 번에 통합하여 제공합니다.
Args: topic: 분석할 입법 주제 또는 키워드 (예: "인공지능", "저출산"). limit: 검색할 관련 법안 수 (기본 5).
Returns: 종합 분석 리포트 데이터.
Inputs: topic (required), limit. Returns: result
analyze_voting_trendsA
특정 주제(키워드)와 관련된 법안들의 본회의 투표 경향을 분석합니다. 최근 관련 법안들의 가결 여부와 찬반 통계를 요약하여 제공합니다.
Args: topic: 분석할 주제 또는 키워드 (예: "종합부동산세", "간호법").
Inputs: topic (required). Returns: object
bill_timelineA
특정 의안의 발의, 위원회 회부, 회의, 본회의 표결, 최종 처리 이벤트를 정규화된 타임라인으로 반환합니다.
기존 get_bill_history보다 event_type/source_tool/confidence 필드를 명시해 LLM이 후속 검증을 이어가기 쉽게 합니다.
Inputs: bill_id (required), age. Returns: object
call_api_rawA
모든 국회 OpenAPI를 직접 호출하는 만능 백도어입니다.
"해당 기능이 없다"는 답을 피하기 위해 항상 이 경로를 고려하세요.
절차: list_api_services로 ID 찾기 → get_api_spec로 파라미터 확인 → 여기서 호출.
응답을 받은 뒤, 필요한 경우 다른 고수준 툴(예: get_member_info, get_meeting_records)로 후속 검색을 연쇄 호출해 답을 완성하세요.
[주의] 이 툴은 입력값을 변환하지 않고 그대로 전송합니다.
특히 'UNIT_CD'(대수) 파라미터는 반드시 '1000xx' 형식을 사용해야 합니다. (예: 22대 국회 -> "100022", 21대 국회 -> "100021") 단순히 "22"라고 입력하면 데이터가 조회되지 않습니다.
Args: service_id: The ID of the service to call (e.g., 'OO1X9P001017YF13038'). params: JSON string of query parameters (e.g., '{"pSize": 5}').
Returns: Raw JSON response as a string.
Inputs: service_id (required), params. Returns: result
get_api_code_guideA
국회 API에서 공통으로 사용되는 코드값(대수, 처리상태 등) 가이드를 반환합니다. LLM이 call_api_raw를 호출하기 전 파라미터 값을 결정할 때 참고하세요.
Inputs: no named parameters. Returns: object
get_api_specA
특정 API 서비스의 상세 스펙을 조회합니다.
이 툴은 엔드포인트 URL, 요청 파라미터(타입/제약조건), 응답 구조 등 전체 API 명세를 반환합니다. 고수준 툴이 제공하지 않는 정보를 조회하기 위해 동적으로 API를 탐색할 때 유용합니다.
기능:
파라미터 제약조건 전체 반환.
데이터 미리보기(Data Preview): 실제 데이터 1건을 조회하여 값의 형식을 보여줍니다.
파라미터 힌트(Parameter Hints): 실제 데이터를 기반으로 유효한 입력값을 제안합니다 (예: UNIT_CD="22대").
워크플로우:
'list_api_services(keyword)'로 서비스 ID 검색
이 툴을 호출하여 파라미터 상세 확인
'call_api_raw(service_id, params)'로 맞춤형 API 호출
Args: service_id: 서비스 ID (예: 'O4K6HM0012064I15889')
Returns: 파라미터와 엔드포인트를 포함한 전체 API 스펙
Inputs: service_id (required). Returns: object
get_assembly_infoC
전체 요약 + 필수 사용 가이드.
총 270여 개의 국회 OpenAPI를 모두 사용할 수 있습니다. 고수준 툴은 일부만 래핑하지만, list_api_services → get_api_spec → call_api_raw 조합으로 어떤 정보든 조회 가능합니다.
"이 기능은 없다"라고 답하지 마세요. 고수준 툴에 없으면 서비스를 검색해 직접 호출하거나 연쇄 호출로 답을 구성하세요.
Returns basic server status plus 이 조합 워크플로우를 안내합니다.
Inputs: no named parameters. Returns: result
get_bill_detailsA
특정 의안의 상세 정보를 조회합니다. 의안의 요약(MAJOR_CONTENT)과 제안 이유(PROPOSE_REASON)를 포함합니다.
사용법:
'search_bills'로 의안 검색 후 'BILL_ID' 또는 'BILL_NO' 확인
이 툴에 ID를 전달하여 상세 내용 조회
Args: bill_id: 의안 ID (예: 'PRC_...') 또는 의안 번호 (예: '2200001'). age: 선택적 대수 (예: "22").
Returns: 상세 정보가 포함된 의안 객체. 결과가 없으면 null을 반환합니다.
Inputs: bill_id (required), age. Returns: result
get_bill_historyA
특정 의안의 발의부터 현재까지의 모든 주요 이력(회의 포함)을 날짜순으로 통합하여 조회합니다. 타임라인 생성이나 연혁 분석에 매우 유용합니다.
Args: bill_id: 의안 ID (예: 'PRC_...') 또는 의안 번호 (예: '2200001').
Inputs: bill_id (required). Returns: result
get_bill_voting_resultsA
특정 의안에 대한 본회의 표결 결과(찬성, 반대, 기권 수)와 정당별 투표 경향을 조회합니다.
Args: bill_id: 의안 ID (예: 'PRC_...').
Inputs: bill_id (required). Returns: object
get_committee_infoB
위원회 목록을 조회하거나 특정 위원회의 상세 정보(위원 명단 포함)를 가져옵니다.
Args: committee_name: 위원회명 (예: "법제사법위원회"). committee_code: 위원회 코드 (HR_DEPT_CD). page: 페이지 번호 (기본 1). limit: 최대 결과 수 (기본 50).
Returns: 위원회 목록 또는 특정 위원회 상세 정보.
Inputs: page, limit, committee_code, committee_name. Returns: result
get_committee_work_summaryA
특정 위원회의 현재 활동 현황(계류 의안, 관련 보고서 등)을 한 번에 조회합니다. 엔티티 간의 연관 데이터를 매핑하여 객관적인 정보를 제공합니다.
Args: committee_name: 위원회명 (예: "법제사법위원회", "환경노동위원회").
Inputs: committee_name (required). Returns: object
get_legislative_reportsA
특정 주제나 법안과 관련된 국회 전문 보고서(NABO Focus 등) 및 뉴스를 조회합니다. 단순 법안 정보를 넘어 전문가의 분석 시각을 제공할 때 유용합니다.
Args: keyword: 검색 키워드 (예: "종합부동산세", "인공지능"). limit: 검색 결과 수 (기본 5).
Inputs: keyword (required), limit. Returns: result
get_legislative_research_kitA
AssemblyMCP를 처음 호출하는 LLM/클라이언트를 위한 공개 도구 표면과 워크플로 계약을 반환합니다.
기능:
검증/브리핑/타임라인/관계도/모니터링 중심의 권장 도구 경로 안내
공개 도구명 네이밍 규칙과 호환성 정책 설명
[NOT_FOUND], [AMBIGUOUS], [VERIFY_FAILED], [API_FAILED], [PARTIAL] 실패 마커 의미 제공
Inputs: no named parameters. Returns: object
get_member_infoA
국회의원 상세 정보를 검색합니다. 발의자가 누구인지, 소속 정당, 지역구 등을 파악할 때 유용합니다.
Args: name: 의원명 (예: "홍길동").
Returns: 국회의원 정보 목록.
Inputs: name (required). Returns: result
get_member_voting_historyA
국회의원 개인의 본회의 표결 기록 또는 특정 의안의 개별 의원 표결 현황을 조회합니다.
Args: name: 의원 성명 (특정 의원의 이력을 볼 때 사용). bill_id: 의안 ID (특정 의안에 누가 어떻게 투표했는지 볼 때 사용). age: 국회 대수 (기본 "22"). page: 페이지 번호. limit: 결과 수 (최대 100).
Inputs: age, name, page, limit, +1 more. Returns: result
get_plenary_scheduleA
본회의 일정을 조회합니다. (Service ID: ORDPSW001070QH19059)
unit_cd(대수) 파라미터가 중요합니다. (예: "22")
데이터가 없는 경우도 많으니 빈 결과가 나오면 대수를 변경하거나 생략해보세요.
Args: unit_cd: 대수 (예: "22"). 생략 시 전체 조회될 수 있음. page: Page number (default 1). limit: Max results (default 10).
Inputs: page, limit, unit_cd. Returns: result
get_representative_reportA
특정 국회의원의 종합 의정활동 리포트를 생성합니다. 인적사항, 최근 대표 발의 법안, 위원회 경력, 최근 본회의 투표 이력을 한 번에 제공합니다.
Args: member_name: 국회의원 성명 (예: "추경호").
Inputs: member_name (required). Returns: object
issue_briefB
입법 주제에 대한 워크플로형 브리프를 생성합니다.
관련 의안, 소관 위원회, 회의 일정/기록, 국회 보고서/뉴스, 본회의 표결 신호를 조합하고 일부 하위 조회 실패는 [PARTIAL] 경고로 보존합니다.
Inputs: topic (required), age, limit. Returns: object
legislative_impact_mapC
주제 또는 의안을 중심으로 법안, 위원회, 의원, 보고서, 표결 신호의 관계 그래프를 생성합니다.
target_type은 auto/topic/bill을 지원합니다. 결과는 nodes, edges, mermaid, top_followups로 구성됩니다.
Inputs: target (required), age, limit, target_type. Returns: object
list_api_servicesA
모든 OpenAPI(총 270여 개) 메타데이터를 검색합니다.
고수준 툴에 없다고 끝내지 말고, 여기서 서비스 ID를 찾은 뒤 get_api_spec → call_api_raw 로 직접 호출하세요.
키워드는 넓게 잡으세요. 국문/영문, 띄어쓰기/부분 문자열 모두 시도해볼 것.
Args: keyword: Keyword to search in service name or description.
Returns: List of services matching the keyword. Each item contains id, name, and description.
Inputs: keyword. Returns: result
pingA
Check if server is alive.
Inputs: no named parameters. Returns: result
search_billsA
의안을 검색하거나 목록을 조회합니다. (통합 검색 도구)
기능:
키워드 검색: 'keyword'만 입력 (예: "인공지능")
필터 검색: 'proposer'(발의자), 'bill_id', 'proc_status' 등 조합
최신 목록: 파라미터 없이 호출하면 현재 대수의 최신 발의 의안 반환
스마트 검색: 키워드 검색 시 현재 대수(22대) 결과가 없으면 이전 대수(21대) 자동 검색
Args: keyword: 검색어 (의안명). bill_id: 의안 고유 ID 또는 의안 번호. proposer: 제안자(의원명 등). age: 국회 대수 (기본 "22"). propose_dt: 제안일자 (YYYYMMDD). proc_status: 처리상태 코드. page: 페이지 번호 (기본 1). limit: 최대 결과 수 (기본 10).
Returns: 검색된 의안 목록. 결과가 없으면 MCP output schema 호환을 위해 빈 배열을 반환합니다.
Inputs: age, page, limit, bill_id, +4 more. Returns: result
search_meetingsA
위원회 회의 정보를 검색합니다.
Args: bill_id: 특정 의안과 관련된 회의를 찾을 때 사용 (예: '2100001'). committee_name: 위원회명 (예: "법제사법위원회"). date_start: 시작일 (YYYY-MM-DD). date_end: 종료일 (YYYY-MM-DD). page: 페이지 번호 (기본 1). limit: 최대 결과 수 (기본 10).
Returns: 회의록 및 일정 목록.
Inputs: page, limit, bill_id, date_end, +2 more. Returns: result
verify_legislative_claimsA
의안/의원/위원회/표결 주장 또는 인용을 국회 OpenAPI 데이터로 검증합니다.
입력 형식:
JSON 배열: [{"type": "bill", "value": "간호법안"}, {"type": "member", "value": "홍길동"}]
JSON 객체: {"type": "vote", "bill_id": "PRC_...", "expected": {"yes": 180}}
일반 텍스트: 자동으로 의안/의원/위원회 후보를 순차 확인합니다.
실패는 [NOT_FOUND], [AMBIGUOUS], [VERIFY_FAILED], [API_FAILED] 마커가 포함된 구조화 객체로 반환됩니다.
Inputs: citations_or_text (required), age, limit. Returns: object
watch_action_planA
특정 입법 주제의 변화를 추적하기 위한 실행 계획과 다음 MCP 호출 목록을 생성합니다.
법률 자문이 아니라 국회 공개데이터 모니터링 절차를 반환합니다.
Inputs: topic (required), age, limit. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 26 tools
Several tools have overlapping mandates: bill_timeline duplicates get_bill_history, get_legislative_research_kit overlaps get_assembly_info, and analyze_legislative_issue/issue_brief both produce comprehensive topic reports. Voting and committee tools are mostly distinct, but the duplication makes tool selection ambiguous.
Most tools follow a get_/ search_/ analyze_ verb-noun pattern, but a few noun-first names (bill_timeline, legislative_impact_map, watch_action_plan, issue_brief) and meta tools break the pattern. It is still readable because the prefixes are clear when present.
26 tools is above the comfortable range for an MCP surface, and several could be consolidated (bill history/timeline, issue brief/analysis, the two meta guides). The broad National Assembly domain and raw API backdoor justify some size, but the effective surface feels inflated.
The set covers core legislative workflows: bill search/detail/history, voting results, member info, committee info, meetings, schedules, and reports. The list_api_services/get_api_spec/call_api_raw pipeline plus get_api_code_guide provides an escape hatch for uncovered OpenAPI endpoints, leaving only minor high-level convenience gaps.
Maintenance
Related MCP Connectors
Korea Law MCP — South Korean national statutes via the Ministry of Government Legislation's (법제처)…
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Access U.S. congressional data (bills, votes, members, committees) via MCP.
Korea-native MCP gateway: Korean commerce, payments, messaging, gov & finance APIs for AI agents.
Related MCP Servers
- FlicenseAqualityBmaintenanceEnables AI systems to search, retrieve, and analyze Korean legal information from the National Law Information API (law.go.kr), including laws, administrative rules, English translations, and law-ordinance linkages.262-
- AlicenseNot gradedqualityDmaintenanceEnables 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 npm94MIT
- AlicenseAqualityCmaintenanceMCP server for the Korean National Assembly Open API, enabling querying of bills, members, votes, committees, and more via natural language.2051 PyPIApache 2.0
- AlicenseCqualityCmaintenanceEnables exploration of Korean National Assembly data by connecting bills, committee reviews, and official records. Allows users to ask natural language questions and receive structured answers with citations to original documents.829Apache 2.0