README.md•3.36 kB
# 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](#example-questions-for-llms)
- [Installation](#installation)
- [Development](#development)
- [Deployment](#deployment)
- [API Functions](#api-functions)
- [Environment](#environment)
- [Connect Claude Desktop](#connect-claude-desktop-to-your-mcp-server)
- [Contributing](#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](https://www.npmjs.com/package/mcp-remote).
To connect from Claude Desktop, follow [Anthropic's Quickstart](https://modelcontextprotocol.io/quickstart/user) 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.