Kokkai Diet

@pipeworx/kokkai-diet

1947年までさかのぼる日本の国会会議録の発言単位の全文検索です。両院のすべての記録済み発言について、発言者、政党、会議、日付、パーマリンクを確認できます。

Pipeworx の一部です。AI エージェントを1882以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流のプロバイダーとは提携・推奨・公開の関係にありません。

ツール

• search_speeches(query?, speaker?, speaker_group?, house?, from?, until?, start_record?, max_records?) — キーワードや発言者で発言を全文検索します。政党・院・日付範囲による絞り込みも任意で指定できます。ページネーションに対応（1回のリクエストにつき最大100件）。
• search_meetings(query?, meeting_name?, house?, from?, until?, start_record?, max_records?) — 会議名、院、日付範囲で会議・会合を検索します。ページネーションに対応（1回のリクエストにつき最大10件。発言検索より上限が低くなっています）。
• get_speech(speech_id) — speechIDを指定して、発言1件の全文とメタデータを取得します。

認証

認証キーは不要です。

データソース

• https://kokkai.ndl.go.jp/api/speech — 発言単位の全文検索。
• https://kokkai.ndl.go.jp/api/meeting — 会議単位の検索。

どちらも、国立国会図書館の国会会議録検索システムが提供するJSON/XMLエンドポイントです。

次に作業する人への注意点

• APIでは、実際の検索条件を指定する必要があります。 from／until／nameOfHouse だけでも受け付けられます（200 OK）が、フィルターにすぎず、検索条件ではないため、結果は何も返されません。search_speeches では query または speaker のいずれかが必要です。search_meetings では query、meeting_name、house のいずれかが必要です。条件なしのリクエストは (19007)検索条件を指定してください を返し、400エラーになります。
• エンドポイントごとに1リクエストあたりの取得件数の上限が異なり、範囲外の値を指定すると上限値に丸められず400エラーになります。 /api/speech の maximumRecords は1～100（デフォルト30）です。/api/meeting の maximumRecords は1～10（デフォルト3）で、発言検索の上限の3分の1なので見落としやすい点に注意してください。ここにある両方のツールではクライアント側で有効な範囲に収めますが、上流のドキュメントをそのまま参照する呼び出し元は、範囲外の値を指定すると (19005)／(19006) エラーになります。
• 上限に達したページを結果全体として扱わないでください。 両方のツールは next_start_record（APIの nextRecordPosition に由来）と is_complete_result（next_start_record が null の場合のみ true）を返します。total（上流の numberOfRecords）が実際の件数です。結果をすべて確認できたと判断する前に、呼び出し元は total と returned を照合する必要があります。
• クエリは日本語を優先してください。 全文インデックスは日本語で、部分一致では日本語の文字列が使われます。英語のキーワード（例：「semiconductors」）では、日本語で大きな議論が行われていても、該当結果が少なかったり、何も返されなかったりします。日本語のキーワード（例：「半導体」）を使ってください。結果が空の場合に「この話題について議論がなかった」と誤解されないよう、ツールの説明にも明記しています。
• search_speeches が返すのは発言のプレビュー（400文字）で、全文ではありません。検索結果に含まれる speech_id を使って get_speech(speech_id) を呼び出し、発言の全文を取得してください。これにより、数千文字に及ぶ発言によってリストの応答が肥大化するのを防げます。
• 上流から返される400エラーの本文には、有用な日本語のメッセージと詳細の配列が含まれています（例：(19005)maximumRecordsには1～100の値を指定してください）。どのパラメーターに誤りがあるのか呼び出し元に正確に伝わるよう、このパックでは一般的なHTTPエラーではなく、そのテキストをそのまま表示します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/kokkai-diet/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的なものであり、偶発的な多重化ではありません。メタツールを使うことで、このパックが対応していない質問にも、カタログ全体を横断する ask_pipeworx を介して回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル 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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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