Kokkai Minutes MCP Agent

A Model Context Protocol (MCP) agent that provides a structured interface to the Japanese National Diet Library's Kokkai Minutes (parliamentary proceedings) API. This agent allows AI models to search and retrieve parliamentary proceedings through a standardized interface.

🚀 Already Deployed: The agent is live and ready to use at https://kokkaikaigiroku-mcp.egeg.workers.dev/mcp

Example Questions for LLMs

Here are some example questions you can ask AI models (like Claude) that use this agent:

Policy Research

"Give me the list of politicians that talked about problems with 仮放免 (provisional release) in the last year"
"What were the main arguments made about 入管法改正 (immigration law reform) in recent Diet sessions?"
"Summarize discussions about 待機児童 (childcare waiting lists) from 2020 to present"

Political Analysis

"How has the government's stance on 原発再稼働 (nuclear power plant restart) evolved over time?"
"Find statements by the Prime Minister about インバウンド観光 (inbound tourism) after COVID-19"
"Compare different party positions on 消費税 (consumption tax) in budget committee meetings"

Historical Research

"Find debates about 日米安保条約 (US-Japan Security Treaty) from its original ratification period"
"How did the Diet discuss 少子化対策 (measures against declining birthrate) when it first became a social issue?"

API Functions

The agent provides three main functions:

searchMeetingList - Search for meetings with basic information
searchMeetingsWithSpeechText - Search for meetings including full speech texts
searchSpeeches - Search for specific speeches

Each function supports various parameters including:

Date range (from, until)
House selection (nameOfHouse)
Speaker information (speaker, speakerPosition, speakerGroup)
Content search (any)
Session numbers (sessionFrom, sessionTo)
And more

For detailed parameter information, please refer to the source code documentation.

Environment

Node.js
TypeScript
Cloudflare Workers
Model Context Protocol SDK

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Connect Claude Desktop to your MCP server

You can connect to the MCP server from local MCP clients using the mcp-remote proxy.

To connect from Claude Desktop, follow Anthropic's Quickstart and within Claude Desktop go to Settings > Developer > Edit Config.

Update with this configuration:

{ "mcpServers": { "kokkaikaigiroku": { "command": "npx", "args": [ "mcp-remote", "https://kokkaikaigiroku-mcp.egeg.workers.dev/mcp" // Use this for the deployed version // or "http://localhost:8787/mcp" for local development ] } } }

Restart Claude and you should see the Kokkai Minutes search tools become available.