houan-mcp
@codeagentjp/houan-mcp
Lokaler stdio-MCP-Server zur Suche nach japanischen Gesetzesentwürfen (衆参議案情報) und Ausschuss-Protokollen über die NDL Kokkai (国会会議録検索システム) API.
Dieser Server ruft kein LLM auf. Er liefert lediglich quellengestützte Daten aus dem Parlament mit primären URLs (NDL Kokkai, 衆議院議案情報, 参議院議案情報), sodass Ihr MCP-Client (Claude Desktop, Claude Code, Cursor oder ein anderer Agent) die Originalquelle zitieren kann.
Schwesterpaket: @codeagentjp/egov-law-mcp für aktuelle japanische Gesetze (e-Gov Law Search). houan-mcp deckt den Bereich des Gesetzgebungsprozesses ab: Gesetzesentwürfe in der Beratung, Ausschussbefragungen und vollständige Sitzungsprotokolle.
Status
MVP. Vier Tools:
find_diet_qa— Volltextsuche in allen Reden der Parlamentsausschüsse über die NDL Kokkai-API. Filterbar nach Datum, Kammer, Ausschuss, Redner.get_meeting_record— Abruf des vollständigen Protokolls eines Ausschusses über dieissueID.search_bills— Suche nach Gesetzesentwürfen der aktuellen Sitzungsperiode in beiden Kammern nach Titel-Stichwort.get_bill— Abruf von Details zu einem Gesetzesentwurf (Verfahrensverlauf, Ausschusszuweisung, URL zum Volltext).
Related MCP server: open-assembly-mcp
Anforderungen
Node.js 20 oder neuer
Netzwerkzugriff auf
https://kokkai.ndl.go.jp,https://www.shugiin.go.jp,https://www.sangiin.go.jp
Installation
Über npm:
{
"mcpServers": {
"houan": {
"command": "npx",
"args": ["-y", "@codeagentjp/houan-mcp"]
}
}
}Aus dem Quellcode:
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"]
}
}
}Tools
find_diet_qa
Volltextsuche in den Reden der Parlamentsausschüsse über die NDL Kokkai-API.
{
"keyword": "クロード ミトス",
"from": "2026-04-01",
"until": "2026-04-25",
"chamber": "衆議院",
"committee": "外務委員会",
"limit": 5
}Gibt die gefundenen Reden mit Redner, Position, Ausschusskontext und direkter NDL-URL zurück.
get_meeting_record
Abruf eines vollständigen Protokolls über die issueID.
{
"issueID": "122103968X00620260410"
}search_bills
Suche in 衆議院議案情報 / 参議院議案情報 nach Titel-Stichwort.
{
"keyword": "情報",
"chamber": "both",
"session": 221,
"limit": 20
}get_bill
Abruf einer Detailseite zu einem Gesetzesentwurf (Verfahrensverlauf, Ausschusszuweisung, URL zum Volltext). Die proceedingURL muss eine von search_bills zurückgegebene URL sein — sie wird vor dem Abruf gegen das erlaubte Pfadpräfix der Kammer validiert.
{
"chamber": "shugiin",
"proceedingURL": "https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/keika/1DE..."
}Datenquellen und Quellenangaben
Dieses Paket nutzt drei öffentliche japanische Quellen:
NDL Kokkai (国会会議録検索システム) — https://kokkai.ndl.go.jp/ · API-Dokumentation. Parlamentsprotokolle veröffentlicht ab 1947. Keine Authentifizierung erforderlich. Bitte seien Sie ein guter Nachbar: Fügen Sie kurze Verzögerungen zwischen aufeinanderfolgenden Anfragen ein und vermeiden Sie gleichzeitige Anfrageschübe.
衆議院議案情報 — https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/menu.htm
参議院議案情報 — https://www.sangiin.go.jp/japanese/joho1/kousei/gian/index.htm
Die Ergebnisse der Tools enthalten die Quell-URL. Wenn Sie Ausgaben, die auf diesem Paket basieren, veröffentlichen oder weitergeben, fügen Sie eine entsprechende Quellenangabe hinzu. Empfehlung:
出典: 国会会議録検索システム (https://kokkai.ndl.go.jp/) / 衆議院議案情報 / 参議院議案情報
Beispiel: Abruf einer Mythos-Fragerunde
Die Befragung vom 10.04.2026 im Auswärtigen Ausschuss des Unterhauses durch 宇佐美登 (Team Mirai) zum Anthropic Claude Mythos Preview kann wie folgt abgerufen werden:
{
"tool": "find_diet_qa",
"arguments": {
"keyword": "クロード",
"from": "2026-04-01",
"until": "2026-04-30"
}
}Die Antwort enthält die wörtliche Antwort des Regierungsreferenten 花田貴裕 mit einer meetingURL, die auf das kanonische NDL-Protokoll unter https://kokkai.ndl.go.jp/txt/122103968X00620260410 verweist.
Sicherheitshinweise
Dieses Paket ist ein gesetzgeberisches Referenzwerkzeug, keine Rechts- oder Politikberatung.
Es führt keine Shell-Befehle aus.
Es schreibt JSON-RPC-Nachrichten nur nach stdout und protokolliert nur nach stderr.
Es ruft nur die NDL Kokkai-API und die Endpunkte für 衆/参 議案情報 ab.
Parlamentsprotokolle in der NDL erscheinen typischerweise mit einer Verzögerung von 1–2 Wochen nach der Ausschusssitzung. Wenn eine aktuelle Sitzung nicht gefunden werden kann, versuchen Sie es später erneut oder konsultieren Sie direkt die Videobibliothek der jeweiligen Kammer.
Verwandte Projekte
MCP für aktuelle Gesetze:
@codeagentjp/egov-law-mcpRoadmap (Gesetzes-Diff / Kommunale Verordnungen / Präzedenzfälle MCPs): SHAYOUWORLD/egov-law-mcp#1
Hintergrundartikel: codeagent.jp / Tools
Lizenz
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