Kokkaikaigiroku

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

Table of Contents

• Example Questions
• Installation
• Development
• Deployment
• API Functions
• Environment
• Connect Claude Desktop
• Contributing

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:

1. searchMeetingList - Search for meetings with basic information
2. searchMeetingsWithSpeechText - Search for meetings including full speech texts
3. 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.