ly-mcp

PyPI version Python Docker License: MIT

대만 입법원 API v2를 위한 모델 컨텍스트 프로토콜(MCP) 서버로, 법안, 위원회, 공보, 회의록 및 관련 문서에 대한 포괄적인 액세스를 제공합니다.

기능

이 MCP 서버는 9개 카테고리에 걸쳐 36개의 도구를 제공합니다:

통계 (Statistics)

get_stat: 입법원 API 통계 및 개요 정보 가져오기

법안 (Bills)

list_bills: 회기, 세션, 카테고리, 제안자 및 기타 기준별 필터를 사용하여 법안 목록 조회
get_bill: 특정 법안에 대한 포괄적인 정보 가져오기 (전체 JSON 반환)
get_bill_related_bills: 관련 법안 및 그 연관 관계 조회
get_bill_meets: 다양한 회의에서의 법안 심의 기록 액세스
get_bill_doc_html: 특정 법안의 HTML 문서 내용 검색

위원회 (Committees)

list_committees: 선택적 필터를 사용하여 입법원 위원회 목록 조회
get_committee: 특정 위원회에 대한 상세 정보 가져오기
get_committee_meets: 위원회 회의 기록 및 진행 상황 액세스

공보 (Gazettes)

list_gazettes: 권호 및 공보 ID별 필터를 사용하여 입법원 공보 목록 조회
get_gazette: 특정 공보에 대한 상세 정보 가져오기
get_gazette_agendas: 특정 공보의 의제/내용 가져오기
list_gazette_agendas: 회기, 회의 날짜 등의 필터를 사용하여 모든 공보 의제 목록 조회
get_gazette_agenda: 특정 공보 의제 항목에 대한 상세 정보 가져오기

질의 (Interpellations)

list_interpellations: 의원, 회기, 세션 및 회의 코드별 필터를 사용하여 질의 목록 조회
get_interpellation: 특정 질의에 대한 상세 정보 가져오기
get_legislator_interpellations: 특정 입법위원이 질문자로 참여한 질의 가져오기

IVOD (인터넷 방송)

list_ivods: 회기, 세션, 위원회, 의원 및 영상 유형별 필터를 사용하여 IVOD(인터넷 주문형 비디오) 녹화물 목록 조회
get_ivod: 영상 URL, 대본 및 공보 내용을 포함한 특정 IVOD 녹화물에 대한 상세 정보 가져오기
get_meet_ivods: 특정 회의와 관련된 IVOD 녹화물 가져오기

법률 (Laws)

list_laws: 법률 번호, 카테고리(모법/자법), 상위 법률 번호, 상태 및 권한별 필터를 사용하여 법률 목록 조회
get_law: 기본 데이터, 조항 및 버전 정보를 포함한 특정 법률에 대한 포괄적인 정보 가져오기
get_law_progress: 특정 법률에 대한 미결 진행 목록 가져오기
get_law_bills: 선택적 필터를 사용하여 특정 법률과 관련된 법안 가져오기
get_law_versions: 변경 사항, 제안자 및 진행 상황을 포함한 특정 법률의 과거 버전 기록 가져오기
list_law_contents: 법률 번호, 버전 ID, 조항 번호, 현재 버전 상태 및 버전 추적별 필터를 사용하여 법률 조항/내용 목록 조회
get_law_content: 법률 내용 ID를 사용하여 특정 법률 조항/내용에 대한 상세 정보 가져오기

회의 (Meets)

list_meets: 회기, 세션, 회의 유형, 참석자, 날짜, 위원회 코드 및 회의 ID별 필터를 사용하여 입법원 회의 목록 조회
get_meet: 회의 ID/코드를 사용하여 특정 회의에 대한 상세 정보 가져오기
get_meet_ivods: 선택적 필터를 사용하여 특정 회의와 관련된 IVOD 녹화물 가져오기
get_meet_bills: 법안 기준별 필터를 사용하여 특정 회의에서 논의된 법안 가져오기
get_meet_interpellations: 선택적 필터를 사용하여 특정 회의에서 발생한 질의 가져오기

입법위원 (Legislators)

list_legislators: 회기, 정당, 지역구 이름, 입법위원 ID 및 이름별 필터를 사용하여 입법위원 목록 조회
get_legislator: 회기 및 이름을 사용하여 특정 입법위원에 대한 상세 정보 가져오기
get_legislator_propose_bills: 법안 기준별 필터를 사용하여 특정 입법위원이 제안한 법안 가져오기
get_legislator_cosign_bills: 법안 기준별 필터를 사용하여 특정 입법위원이 공동 서명한 법안 가져오기
get_legislator_meets: 회의 기준별 필터를 사용하여 특정 입법위원이 참석한 회의 가져오기
get_legislator_interpellations: 선택적 필터를 사용하여 특정 입법위원이 수행한 질의 가져오기

API 출처

이 MCP 서버는 입법원 API v2를 데이터 소스로 사용하여 대만 입법원의 법안 및 회의 절차에 대한 정보를 제공합니다.

설치 및 사용

빠른 시작

uvx를 사용하여 서버를 설치하고 실행하세요:

uvx lymcp@latest

MCP 클라이언트 구성

MCP 클라이언트 구성(예: Claude Desktop)에 서버를 추가하세요:

PyPI

{
  "mcpServers": {
    "lymcp": {
      "command": "uvx",
      "args": ["lymcp@latest"]
    }
  }
}

GitHub

{
  "mcpServers": {
    "lymcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/narumiruna/ly-mcp",
        "lymcp"
      ]
    }
  }
}

로컬 개발

{
  "mcpServers": {
    "lymcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/ly-mcp",
        "lymcp"
      ]
    }
  }
}

Docker

{
  "mcpServers": {
    "lymcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "narumi/ly-mcp:latest"
      ]
    }
  }
}

예시 프롬프트

MCP 서버에 연결되면 LLM에게 다음과 같이 질문할 수 있습니다:

"列出第11屆的所有法律提案" (제11대 모든 법률 제안 목록 조회)
"查詢立法委員王美花的提案紀錄" (입법위원 왕메이화의 제안 기록 조회)
"最近一次院會討論了哪些議案？" (가장 최근 원회에서 논의된 법안은 무엇인가요?)
"查詢勞動基準法的修法歷程" (노동기준법의 개정 이력 조회)
"第11屆第1會期有哪些委員會會議？" (제11대 제1회기에 열린 위원회 회의는 무엇인가요?)

개발

사전 요구 사항

Python 3.12+
uv 패키지 관리자
just 명령 실행기

설정

git clone https://github.com/narumiruna/ly-mcp
cd ly-mcp
uv sync

MCP 인스펙터 실행

just dev

테스트 실행

# Run full test suite with coverage
just test

# Run tests with verbose output
uv run pytest -v -s

코드 품질

# Run linter
just lint

# Run type checker
just type

라이선스

MIT

Taiwan Legislative Yuan MCP Server