houan-mcp
@codeagentjp/houan-mcp
Локальный stdio MCP-сервер для поиска законопроектов японского парламента (衆参議案情報) и протоколов заседаний комитетов через API NDL Kokkai (国会会議録検索システム).
Этот сервер не обращается к LLM. Он возвращает только данные о парламенте с указанием первоисточников (NDL Kokkai, 衆議院議案情報, 参議院議案情報), чтобы ваш MCP-клиент (Claude Desktop, Claude Code, Cursor или любой другой агент) мог ссылаться на оригинальный источник.
Родственный пакет: @codeagentjp/egov-law-mcp для поиска действующих законов Японии (e-Gov Law Search). houan-mcp охватывает сторону законодательного процесса: законопроекты на стадии рассмотрения, вопросы в комитетах и полные стенограммы заседаний.
Статус
MVP. Четыре инструмента:
find_diet_qa— полнотекстовый поиск по всем выступлениям в комитетах парламента через API NDL Kokkai. Фильтрация по дате, палате, комитету, выступающему.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
Полнотекстовый поиск по выступлениям в комитетах парламента через API NDL Kokkai.
{
"keyword": "クロード ミトス",
"from": "2026-04-01",
"until": "2026-04-25",
"chamber": "衆議院",
"committee": "外務委員会",
"limit": 5
}Возвращает найденные выступления с указанием выступающего, должности, контекста комитета и прямой ссылки на NDL.
get_meeting_record
Получение полной стенограммы заседания по issueID.
{
"issueID": "122103968X00620260410"
}search_bills
Поиск в 衆議院議案情報 / 参議院議案情報 по ключевым словам в названии.
{
"keyword": "情報",
"chamber": "both",
"session": 221,
"limit": 20
}get_bill
Получение страницы с подробной информацией о законопроекте (хронология рассмотрения, назначение комитета, URL полного текста). proceedingURL должен быть URL-адресом, возвращенным инструментом search_bills — перед выполнением запроса он проверяется на соответствие разрешенному префиксу пути палаты.
{
"chamber": "shugiin",
"proceedingURL": "https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/keika/1DE..."
}Источники данных и атрибуция
Этот пакет использует три японских публичных источника:
NDL Kokkai (国会会議録検索システム) — 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/) / 衆議院議案情報 / 参議院議案情報
Пример: получение Q&A по Mythos
Вопрос, заданный 10 апреля 2026 года на заседании Комитета по иностранным делам Палаты представителей Усами Нобору (команда «Мирай») о Claude Mythos Preview от Anthropic, можно получить следующим образом:
{
"tool": "find_diet_qa",
"arguments": {
"keyword": "クロード",
"from": "2026-04-01",
"until": "2026-04-30"
}
}Ответ включает дословный ответ правительственного эксперта Ханада Такахиро с meetingURL, указывающим на каноническую запись NDL по адресу https://kokkai.ndl.go.jp/txt/122103968X00620260410.
Примечания по безопасности
Этот пакет является инструментом для работы с законодательными документами, а не юридической или политической консультацией.
Он не выполняет команды оболочки.
Он записывает сообщения JSON-RPC только в stdout, а логи — только в stderr.
Он обращается только к API NDL Kokkai и конечным точкам 衆/参 議案情報.
Протоколы заседаний парламента в NDL обычно появляются с задержкой в 1–2 недели после заседания комитета. Если недавнее заседание не найдено, проверьте позже или обратитесь напрямую к видеоархиву палаты.
См. также
Родственный MCP для действующих законов:
@codeagentjp/egov-law-mcpДорожная карта (法令diff / 自治体条例 / 判例 MCPs): SHAYOUWORLD/egov-law-mcp#1
Фоновая статья: codeagent.jp / Tools
Лицензия
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