mcpField
K
Kokkai Minutes MCP Agent

Kokkai Minutes MCP Agent

Local
github.com/egegungorduAI & Agents1Updated 73w ago
Repository

About Kokkai Minutes MCP Agent

Kokkai Minutes MCP Agent connects AI models to the Japanese National Diet Library’s parliamentary proceedings API. It supports meeting and speech searches with filters for researchers studying policy, politics, and parliamentary history.

Key features

  1. 01Search meeting listings
  2. 02Search meetings with speech text
  3. 03Find specific speeches
  4. 04Filter by dates, house, speaker, and topic

Use cases

  1. 01Research Diet debate on a policy
  2. 02Track a politician’s statements over time
  3. 03Compare party positions in committee meetings

MCP support

It exposes tools for searching Kokkai Minutes meetings and speeches to MCP clients, including searches that return full speech text.

#typescript#mcp#japan#cloudflare-workers#kokkai#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "kokkaikaigiroku": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote"
      ]
    }
  }
}
Run commandnpx -y mcp-remote

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-remote

Tools

3

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
startRecordintegerNoStart position for retrieving search results (1-based). Default is 1.
nameOfHouseenumNoName of the House (e.g., '衆議院' for House of Representatives, '参議院' for House of Councillors). '両院' and '両院協議会' yield the same results.衆議院 | 参議院 | 両院 | 両院協議会
nameOfMeetingstringNoName of the meeting (e.g., plenary session, committee). Partial match. Multiple terms separated by space for OR search.
anystringNoKeywords to search in speech content. Partial match. Multiple terms separated by space for AND search.
speakerstringNoSpeaker's name. Partial match. Multiple names separated by space for OR search.
fromstringNoStart date for meeting search (YYYY-MM-DD). Default '0000-01-01'.
untilstringNoEnd date for meeting search (YYYY-MM-DD). Default '9999-12-31'.
supplementAndAppendixbooleanNoLimit search to supplements and appendices. Default false.
contentsAndIndexbooleanNoLimit search to table of contents and index. Default false.
searchRangeenumNoSpecifies where to search for keywords from 'any' parameter: '冒頭' (opening), '本文' (body), or '冒頭・本文' (both). Default '冒頭・本文'.冒頭 | 本文 | 冒頭・本文
closingbooleanNoLimit search to meetings held during recess. Default false.
speechNumberintegerNoExact match for speech number (e.g., 10).
speakerPositionstringNoSpeaker's position/title. Partial match.
speakerGroupstringNoSpeaker's affiliated political group. Partial match.
speakerRoleenumNoSpeaker's role: '証人' (witness), '参考人' (expert witness/referential speaker), '公述人' (public speaker).証人 | 参考人 | 公述人
speechIDstringNoUnique ID for a speech (format: issueID_paddedSpeechNumber, e.g., '100105254X00119470520_000'). Exact match.
issueIDstringNoUnique ID for a meeting record (21 alphanumeric characters, e.g., '100105254X00119470520'). Exact match.
sessionFromintegerNoStarting Diet session number (up to 3 digits).
sessionTointegerNoEnding Diet session number (up to 3 digits).
issueFromintegerNoStarting issue number (up to 3 digits, 0 for TOC/index/appendix/supplement).
issueTointegerNoEnding issue number (up to 3 digits, 0 for TOC/index/appendix/supplement).
maximumRecordsintegerNoMaximum number of records to retrieve (1-100) for meeting list. Default is 30.

Details

From the project README

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 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.