houan-mcp
@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é porissueID.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:
NDL Kokkai (国会会議録検索システム) — https://kokkai.ndl.go.jp/ · Documentación de la API. Registros de la Dieta publicados desde 1947. No se requiere autenticación. Sea un buen vecino: inserte breves retrasos entre solicitudes secuenciales, evite ráfagas concurrentes.
衆議院議案情報 — https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/menu.htm
参議院議案情報 — https://www.sangiin.go.jp/japanese/joho1/kousei/gian/index.htm
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
MCP hermano para leyes actuales:
@codeagentjp/egov-law-mcpHoja de ruta (法令diff / 自治体条例 / 判例 MCPs): SHAYOUWORLD/egov-law-mcp#1
Artículo de fondo: codeagent.jp / Tools
Licencia
MIT © codeagent.jp
Available Tools
4 toolsfind_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
Scored across 4 tools
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.
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.
Four tools is well-scoped for the domain of Japanese Diet information retrieval. Each tool serves a clear purpose without redundancy or excessive granularity.
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
Related MCP Connectors
Kokkai Diet MCP — Japan National Diet proceedings, speech-level full-text search via the National…
MCP server for searching Airweave collections with natural language queries.
An MCP server that provides congressional transcripts
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server for Japan's TDnet (Timely Disclosure network). Search and retrieve timely disclosure documents from listed companies on Japanese stock exchanges.178 PyPI6Apache 2.0
- 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
- AlicenseAqualityDmaintenanceMCP server for searching and retrieving Japanese laws from the e-Gov API, enabling natural language queries for legal information.314 npmMIT
- AlicenseBqualityDmaintenanceMCP 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.338ISC