@codeagentjp/houan-mcp

NDL 국회(국회회의록 검색 시스템) API를 통해 일본의 국회 의안(衆参議案情報) 및 위원회 질의응답 기록을 검색하기 위한 로컬 stdio MCP 서버입니다.

이 서버는 LLM을 호출하지 않습니다. 오직 출처가 명확한 국회 데이터만을 반환하며, MCP 클라이언트(Claude Desktop, Claude Code, Cursor 등)가 원본 출처를 인용할 수 있도록 기본 URL(국회회의록 검색 시스템, 중의원 의안 정보, 참의원 의안 정보)을 제공합니다.

자매 패키지: 현행 일본 법령을 위한 @codeagentjp/egov-law-mcp (e-Gov 법령 검색). houan-mcp는 입법 과정 측면을 다룹니다: 심의 중인 법안, 위원회 질의, 전체 회의록.

상태

MVP. 4가지 도구:

• find_diet_qa — NDL 국회 API를 통해 모든 국회 위원회 발언을 전문 검색합니다. 날짜, 원내, 위원회, 발언자별로 필터링할 수 있습니다.

• get_meeting_record — issueID를 사용하여 특정 위원회의 전체 회의록을 가져옵니다.

• search_bills — 제목 키워드로 양원(중의원/참의원)의 현재 회기 법안을 검색합니다.

• get_bill — 법안 상세 정보(진행 타임라인, 위원회 배정, 전문 URL)를 가져옵니다.

Related MCP server: open-assembly-mcp

요구 사항

• Node.js 20 이상

• https://kokkai.ndl.go.jp, https://www.shugiin.go.jp, https://www.sangiin.go.jp에 대한 네트워크 접근 권한

설치

npm 사용:

{
  "mcpServers": {
    "houan": {
      "command": "npx",
      "args": ["-y", "@codeagentjp/houan-mcp"]
    }
  }
}

소스에서 설치:

git clone https://github.com/SHAYOUWORLD/houan-mcp.git
cd houan-mcp
node bin/houan-mcp.mjs

{
  "mcpServers": {
    "houan": {
      "command": "node",
      "args": ["/absolute/path/to/houan-mcp/bin/houan-mcp.mjs"]
    }
  }
}

도구

find_diet_qa

NDL 국회 API를 통한 국회 위원회 발언 전문 검색.

{
  "keyword": "クロード ミトス",
  "from": "2026-04-01",
  "until": "2026-04-25",
  "chamber": "衆議院",
  "committee": "外務委員会",
  "limit": 5
}

발언자, 직책, 위원회 맥락 및 직접적인 NDL URL이 포함된 일치하는 발언을 반환합니다.

get_meeting_record

issueID를 사용하여 단일 전체 회의록을 가져옵니다.

{
  "issueID": "122103968X00620260410"
}

search_bills

제목 키워드로 중의원 의안 정보 / 참의원 의안 정보를 검색합니다.

{
  "keyword": "情報",
  "chamber": "both",
  "session": 221,
  "limit": 20
}

get_bill

법안 상세 페이지(진행 타임라인, 위원회 배정, 전문 URL)를 가져옵니다. proceedingURL은 search_bills에서 반환된 URL이어야 하며, 가져오기 전에 해당 원내의 허용된 경로 접두사와 대조하여 검증됩니다.

{
  "chamber": "shugiin",
  "proceedingURL": "https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/keika/1DE..."
}

데이터 출처 및 저작자 표시

이 패키지는 세 가지 일본 공공 출처를 사용합니다:

• NDL 국회(국회회의록 검색 시스템) — https://kokkai.ndl.go.jp/ · API 문서. 1947년부터 발행된 국회 기록. 인증 불필요. 좋은 이웃이 되어주세요: 순차적인 요청 사이에 짧은 지연 시간을 삽입하고, 동시 다발적인 요청은 피하십시오.

• 중의원 의안 정보 — https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/menu.htm

• 참의원 의안 정보 — https://www.sangiin.go.jp/japanese/joho1/kousei/gian/index.htm

도구 결과에는 출처 URL이 포함됩니다. 이 패키지를 기반으로 결과물을 게시하거나 재배포할 때는 적절한 저작자 표시를 포함하십시오. 권장 문구:

출처: 국회회의록 검색 시스템 (https://kokkai.ndl.go.jp/) / 중의원 의안 정보 / 참의원 의안 정보

예시: Mythos 질의응답 가져오기

Anthropic의 Claude Mythos Preview에 대한 2026년 4월 10일 중의원 외무위원회에서의 우사미 노보루(팀 미라이)의 질의는 다음과 같이 가져올 수 있습니다:

{
  "tool": "find_diet_qa",
  "arguments": {
    "keyword": "クロード",
    "from": "2026-04-01",
    "until": "2026-04-30"
  }
}

응답에는 하나다 타카히로 정부 참고인의 답변 전문이 포함되어 있으며, meetingURL은 https://kokkai.ndl.go.jp/txt/122103968X00620260410의 표준 NDL 기록을 가리킵니다.

안전 주의사항

• 이 패키지는 입법 참고 도구이며, 법률/정치적 조언이 아닙니다.

• 셸 명령을 실행하지 않습니다.

• JSON-RPC 메시지는 stdout으로만 작성하며, 로그는 stderr로만 작성합니다.

• NDL 국회 API 및 중의원/참의원 의안 정보 엔드포인트만 가져옵니다.

• NDL의 국회 기록은 일반적으로 위원회 회의 후 1~2주의 시차를 두고 나타납니다. 최근 회의를 찾을 수 없는 경우 나중에 다시 확인하거나 해당 원내의 영상 라이브러리를 직접 참조하십시오.

관련 항목

• 현행 법령을 위한 자매 MCP: @codeagentjp/egov-law-mcp

• 로드맵 (법령 diff / 지방자치단체 조례 / 판례 MCPs): SHAYOUWORLD/egov-law-mcp#1

• 배경 기사: codeagent.jp / Tools

라이선스

MIT © codeagent.jp