Skip to main content
Glama
houan-mcp

houan-mcp

by SHAYOUWORLD

@codeagentjp/houan-mcp

Servidor MCP local stdio para buscar proyectos de ley de la Dieta (衆参議案情報) y registros de preguntas y respuestas de comités japoneses a través de la API de NDL Kokkai (国会会議録検索システム).

Este servidor no llama a un LLM. Solo devuelve datos de la Dieta respaldados por fuentes, con URLs primarias (NDL Kokkai, 衆議院議案情報, 参議院議案情報) para que su cliente MCP (Claude Desktop, Claude Code, Cursor o cualquier otro agente) pueda citar la fuente original.

Paquete hermano: @codeagentjp/egov-law-mcp para leyes japonesas actuales (Búsqueda de leyes e-Gov). houan-mcp cubre el lado del proceso legislativo: proyectos de ley en deliberación, interrogatorios de comités y transcripciones completas de reuniones.

Estado

MVP. Cuatro herramientas:

  • find_diet_qa — búsqueda de texto completo en todos los discursos de los comités de la Dieta a través de la API NDL Kokkai. Filtrar por fecha, cámara, comité, orador.

  • get_meeting_record — recuperar la transcripción completa de un solo comité por issueID.

  • search_bills — buscar proyectos de ley de la sesión actual en cualquiera de las cámaras por palabra clave del título.

  • get_bill — recuperar detalles de un proyecto de ley (cronología de procedimientos, asignación de comité, URL de texto completo).

Related MCP server: open-assembly-mcp

Requisitos

  • Node.js 20 o posterior

  • Acceso a la red a https://kokkai.ndl.go.jp, https://www.shugiin.go.jp, https://www.sangiin.go.jp

Instalación

Desde npm:

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

Desde el código fuente:

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"]
    }
  }
}

Herramientas

find_diet_qa

Búsqueda de texto completo de discursos de comités de la Dieta a través de la API NDL Kokkai.

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

Devuelve los discursos encontrados con el orador, cargo, contexto del comité y URL directa de NDL.

get_meeting_record

Recuperar una transcripción completa única por issueID.

{
  "issueID": "122103968X00620260410"
}

search_bills

Buscar 衆議院議案情報 / 参議院議案情報 por palabra clave del título.

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

get_bill

Recuperar una página de detalles de un proyecto de ley (cronología de procedimientos, asignación de comité, URL de texto completo). La proceedingURL debe ser una URL devuelta por search_bills; se valida contra el prefijo de ruta permitido de la cámara antes de realizar la obtención.

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

Fuentes de datos y atribución

Este paquete utiliza tres fuentes públicas japonesas:

Los resultados de las herramientas incluyen la URL de la fuente. Cuando publique o redistribuya resultados basados en este paquete, incluya una atribución adecuada. Sugerencia:

出典: 国会会議録検索システム (https://kokkai.ndl.go.jp/) / 衆議院議案情報 / 参議院議案情報

Ejemplo: extrayendo una sesión de preguntas y respuestas sobre Mythos

El interrogatorio del 10/04/2026 en el Comité de Asuntos Exteriores de la Cámara de Representantes (衆議院外務委員会) por parte de 宇佐美登 (Equipo Mirai) sobre la vista previa de Claude Mythos de Anthropic se puede recuperar así:

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

La respuesta incluye la respuesta textual de 花田貴裕 (funcionario del gobierno) con la meetingURL apuntando al registro canónico de NDL en https://kokkai.ndl.go.jp/txt/122103968X00620260410.

Notas de seguridad

  • Este paquete es una herramienta de referencia legislativa, no un consejo legal o político.

  • No ejecuta comandos de shell.

  • Solo escribe mensajes JSON-RPC en stdout y registra solo en stderr.

  • Solo obtiene datos de la API NDL Kokkai y los endpoints de 衆/参 議案情報.

  • Los registros de la Dieta en NDL suelen aparecer con un retraso de 1 a 2 semanas después de la reunión del comité. Si no se puede encontrar una reunión reciente, vuelva a consultar más tarde o consulte directamente la biblioteca de videos de la cámara.

Relacionado

Licencia

MIT © codeagent.jp

Available Tools

4 tools
find_diet_qaA

Full-text search of Japanese Diet committee speeches via the NDL Kokkai API. Returns speeches matching the keyword along with speaker, position, committee, and the canonical NDL URL.

Inputs: keyword (required), from, until, chamber, +3 more.

get_billA

Retrieve detail of one bill by chamber and proceedings URL. Returns title, submitter, committee assignment, and a status timeline parsed from the proceedings page. The proceedingURL must be a URL returned by search_bills.

Inputs: chamber (required), proceedingURL (required).

get_meeting_recordA

Retrieve the full transcript of one Diet committee meeting by issueID via the NDL Kokkai API. Use the issueID from a find_diet_qa result.

Inputs: issueID (required).

search_billsA

Search current-session Japanese Diet bills (衆議院議案情報 / 参議院議案情報) by title keyword. Returns bill metadata with proceedings and full-text URLs.

Inputs: keyword (required), chamber, session, limit.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct resource: speeches (find_diet_qa), bills (get_bill, search_bills), and meeting transcripts (get_meeting_record). There is no overlap in functionality, making it easy for an agent to choose the correct tool.

    Naming Consistency3/5

    Tool names mix verb prefixes: 'find', 'get', and 'search'. While all use snake_case, the lack of a uniform verb-noun pattern (e.g., all 'get_...' or all 'search_...') creates mild inconsistency.

    Tool Count5/5

    Four tools is well-scoped for the domain of Japanese Diet information retrieval. Each tool serves a clear purpose without redundancy or excessive granularity.

    Completeness4/5

    The tool set covers search and retrieval for bills, speeches, and meeting transcripts, which are the core needs. Minor gaps exist (e.g., listing all committees or filtering by date), but they don't hinder primary workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Japan's TDnet (Timely Disclosure network). Search and retrieve timely disclosure documents from listed companies on Japanese stock exchanges.
      178 PyPI
      6
      Apache 2.0
    • 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
      MCP server that provides tools and prompts for searching Japanese Diet (国会) proceedings using the National Diet Library API. Enables querying meetings and speeches with various filters and obtaining direct URLs to the records.
      3
      38
      ISC