Skip to main content
Glama
AssemblyMCP

AssemblyMCP

by StatPan

AssemblyMCP

대한민국 국회 정보공개 OpenAPI를 MCP(Model Context Protocol) 도구로 제공하는 서버입니다. LLM 클라이언트가 의안, 의원, 위원회, 회의, 표결, 국회 보고서 데이터를 조회하고 검증형 워크플로로 조합할 수 있게 합니다.

English README

먼저 호출할 도구

LLM 클라이언트는 세션 시작 시 get_legislative_research_kit()을 먼저 호출하는 것을 권장합니다. 이 도구는 공개 도구 목록, 네이밍 규칙, 권장 워크플로, 실패 마커 계약을 구조화 데이터로 반환합니다.

실패 마커는 다음 형태로 반환됩니다.

Marker

의미

[NOT_FOUND]

실제 조회했지만 일치 데이터가 없음

[AMBIGUOUS]

후보가 여러 개라 사용자가 식별자를 좁혀야 함

[VERIFY_FAILED]

데이터는 찾았지만 기대 필드와 불일치

[API_FAILED]

국회 API 또는 서버 호출 중 오류

[PARTIAL]

복합 워크플로 일부 단계 실패, 나머지는 사용 가능

Related MCP server: Korean National Assembly MCP Server

워크플로 중심 도구

Tool

목적

verify_legislative_claims(citations_or_text, age="22", limit=5)

의안, 의원, 위원회, 표결 주장/인용을 국회 데이터로 검증

issue_brief(topic, age="22", limit=5)

주제별 의안, 위원회, 회의, 보고서, 표결 신호를 통합

bill_timeline(bill_id, age=None)

의안의 발의, 회부, 회의, 표결, 최종 처리 이벤트를 정규화

legislative_impact_map(target, target_type="auto", age="22", limit=5)

주제 또는 의안 중심 관계 그래프(nodes/edges/mermaid) 생성

watch_action_plan(topic, age="22", limit=5)

지속 모니터링을 위한 후속 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

목적

search_bills(...)

키워드, 의안 ID, 발의자, 처리상태 등으로 의안 검색

get_bill_details(bill_id, age=None)

의안 상세, 주요 내용, 제안 이유 조회

get_bill_history(bill_id)

기존 호환용 의안 이력 타임라인

analyze_legislative_issue(topic, limit=5)

주제별 기존 종합 분석

get_legislative_reports(keyword, limit=5)

NABO 보고서와 국회 뉴스 검색

get_committee_work_summary(committee_name)

위원회별 계류 의안과 보고서 요약

get_member_info(name)

국회의원 인적사항 검색

get_representative_report(member_name)

의원 기본 정보, 발의 법안, 위원회 경력, 표결 이력 통합

search_meetings(...)

의안 또는 위원회 기준 회의 검색

get_plenary_schedule(unit_cd=None, page=1, limit=10)

본회의 일정 조회

get_committee_info(...)

위원회 목록, 위원회 상세, 위원 명단 조회

get_bill_voting_results(bill_id)

의안별 본회의 표결 결과와 정당별 샘플 경향

analyze_voting_trends(topic)

주제별 표결 경향 분석

get_member_voting_history(...)

의원 또는 의안 기준 개별 표결 기록

Raw API 탐색 도구

AssemblyMCP는 고수준 도구에 없는 데이터도 국회 OpenAPI 메타데이터를 통해 직접 탐색할 수 있습니다.

Tool

목적

list_api_services(keyword="")

사용 가능한 국회 API 서비스 검색

get_api_spec(service_id)

서비스 파라미터, 응답 구조, 샘플 데이터 확인

call_api_raw(service_id, params="{}")

특정 OpenAPI 서비스 직접 호출

get_api_code_guide()

UNIT_CD, 처리상태 코드 등 공통 코드 확인

get_assembly_info()

서버 상태와 사용 가이드 확인

ping()

서버 생존 확인

권장 탐색 순서:

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/AssemblyMCP

Streamable 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 이상

  • uv

설치 및 테스트

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

환경 변수

변수

설명

기본값

ASSEMBLY_API_KEY

국회 OpenAPI 인증키

없음

ASSEMBLY_LOG_LEVEL

로깅 레벨

INFO

ASSEMBLY_LOG_JSON

JSON 구조화 로깅

False

ASSEMBLY_ENABLE_CACHING

인메모리 캐싱

False

ASSEMBLY_CACHE_TTL_SECONDS

캐시 TTL

300

ASSEMBLY_CACHE_MAX_SIZE

최대 캐시 항목 수

100

MCP_TRANSPORT

stdio 또는 http

stdio

MCP_HOST

HTTP 바인드 호스트

0.0.0.0

MCP_PORT

HTTP 포트

8000

MCP_PATH

HTTP MCP 경로

/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 tools
analyze_legislative_issueA

특정 주제(이슈)에 대한 종합적인 입법 현황 분석 리포트를 생성합니다. 이 도구는 관련 법안 검색, 주요 법안의 상세 내용, 관련 위원회 회의록, 그리고 해당 주제를 주도하는 주요 국회의원 정보를 한 번에 통합하여 제공합니다.

Args: topic: 분석할 입법 주제 또는 키워드 (예: "인공지능", "저출산"). limit: 검색할 관련 법안 수 (기본 5).

Returns: 종합 분석 리포트 데이터.

Inputs: topic (required), limit. Returns: result

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대").

워크플로우:

  1. 'list_api_services(keyword)'로 서비스 ID 검색

  2. 이 툴을 호출하여 파라미터 상세 확인

  3. '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)를 포함합니다.

사용법:

  1. 'search_bills'로 의안 검색 후 'BILL_ID' 또는 'BILL_NO' 확인

  2. 이 툴에 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

의안을 검색하거나 목록을 조회합니다. (통합 검색 도구)

기능:

  1. 키워드 검색: 'keyword'만 입력 (예: "인공지능")

  2. 필터 검색: 'proposer'(발의자), 'bill_id', 'proc_status' 등 조합

  3. 최신 목록: 파라미터 없이 호출하면 현재 대수의 최신 발의 의안 반환

  4. 스마트 검색: 키워드 검색 시 현재 대수(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

    B3.1/5.0

    Scored across 26 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      Enables 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.
      26
      2
      -
    • 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
      C
      quality
      C
      maintenance
      Enables 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.
      8
      29
      Apache 2.0