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

Table of Contents

• Example Questions

• Installation

• Development

• Deployment

• API Functions

• Environment

• Connect Claude Desktop

• Contributing

Related MCP server: kokkai-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:

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.