Skip to main content
Glama
houan-mcp

houan-mcp

by SHAYOUWORLD

@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..."
}

Источники данных и атрибуция

Этот пакет использует три японских публичных источника:

Результаты инструментов включают 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 недели после заседания комитета. Если недавнее заседание не найдено, проверьте позже или обратитесь напрямую к видеоархиву палаты.

См. также

Лицензия

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