Kokkai Diet

@pipeworx/kokkai-diet

对日本国会自 1947 年以来的议事记录进行逐次发言全文搜索——涵盖两院及所有记录在案的发言，并提供发言人、党派、会期、日期和永久链接。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1882+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方无关联，未经其认可，也并非由其发布。

工具

• search_speeches(query?, speaker?, speaker_group?, house?, from?, until?, start_record?, max_records?) — 按关键词和／或发言人搜索发言全文，可选择按党派、院别和日期范围筛选。支持分页（每次请求最多 100 条）。
• search_meetings(query?, meeting_name?, house?, from?, until?, start_record?, max_records?) — 按名称、院别或日期范围查找会议／开会记录。支持分页（每次请求最多 10 条，限制低于发言搜索）。
• get_speech(speech_id) — 根据 speechID 获取单条发言的全文和元数据。

身份验证

无需密钥。

数据源

• https://kokkai.ndl.go.jp/api/speech — 逐次发言全文搜索。
• https://kokkai.ndl.go.jp/api/meeting — 会议级别搜索。

两者均为国立国会图书馆「国会会議録検索システム」（国会会议记录检索系统）的 JSON/XML 端点。

给后来者的注意事项

• API 要求提供有效的搜索条件。 仅提供 from／until／nameOfHouse 会被接受（返回 200 OK），但不会报错，只会返回 0 条记录——这些是筛选条件，不是搜索条件。search_speeches 要求提供 query 和／或 speaker；search_meetings 要求提供 query、meeting_name 或 house。不提供条件的请求会返回 400，错误为 (19007)検索条件を指定してください。
• 不同端点的单次请求记录数上限不同，超出范围的值会返回 400，而非自动限制到上限。 /api/speech：maximumRecords 为 1–100（默认值 30）。/api/meeting：maximumRecords 为 1–10（默认值 3）——这个限制很容易被忽略，因为只有发言搜索上限的三分之一。此处的两个工具会在客户端将值限制在有效范围内；但直接查阅上游原始文档的调用方若不做处理，就会遇到 (19005)／(19006)。
• 不要让被截断的分页看起来像完整结果。 两个工具都会返回 next_start_record（取自 API 的 nextRecordPosition）和 is_complete_result（仅当 next_start_record 为 null 时才是 true）。total（上游的 numberOfRecords）是真实总数——调用方必须将其与 returned 对比，才能确认是否已获取全部结果。
• 搜索以日语为主。 全文索引为日语；日语子串支持部分匹配。即使某个主题存在大量日语讨论，英文关键词（例如 "semiconductors"）也可能匹配不足或返回 0 条结果——应使用日语关键词（例如 "半導体"）。工具说明会明确指出这一点，以免调用方将空结果误解为「没有相关讨论」。
• search_speeches 返回的是发言预览（400 个字符），而非全文——请使用搜索结果中的 speech_id 调用 get_speech(speech_id) 获取完整发言。这样可以避免列表响应因包含数千字符的发言而过于庞大。
• 上游返回的 400 错误正文包含有用的日语消息和 details 数组（例如 (19005)maximumRecordsには1～100の値を指定してください）——本集成会原样显示这些文本，而不是返回通用 HTTP 错误，因为它们能明确告知调用方哪个参数有误。

快速开始

将其添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "kokkai-diet": {
      "url": "https://gateway.pipeworx.io/kokkai-diet/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/kokkai-diet/mcp 返回上表中的工具，以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和其余全网关范围的工具。因此，你看到的工具数量会多于此表中的数量：目前，单个工具包端点除了列出该工具包自己的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，也是当天情况的权威信息。

这是有意为之，并非意外地进行了多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需再添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的架构定义比路由带来的收益更占用上下文，建议只连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1882+ 个数据源。唯一的区别在于，直接列出的是哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/search_speeches \
  -H 'Content-Type: application/json' \
  -d '{"query":"半導体","max_records":5}'

首次调用无需账号。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/search_speeches。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账号）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账号，也无需经由网关往返：

{
  "mcpServers": {
    "kokkai-diet": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-kokkai-diet"]
    }
  }
}

或者直接运行，以确认它能启动：

npx -y @pipeworx/mcp-kokkai-diet

它通过 stdin/stdout 使用 MCP 通信，并仅针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接额外提供的任何共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的英语提问，而不是直接调用工具——此方式既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Kokkai Diet data" })

网关会自动选择合适的工具并填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT