kokkai-meeting-mcp-server/README.md

MCP server for Japanese Diet (Kokkai) meeting records API

# Kokkai MCP Server

An MCP (Model Context Protocol) server for accessing Japanese Diet (Kokkai) meeting records through the National Diet Library API.

## Features

- Search Diet meeting records by keywords (like "科学技術")
- Filter by house (衆議院, 参議院, 両院協議会)
- Pagination support
- Session and issue number filtering

## Installation

```bash
npm install
npm run build
```

## Usage

The server provides one tool: `search_kokkai_meetings`

### Example Searches

1. Search for "科学技術" (science and technology):
```json
{
  "any": "科学技術",
  "maximumRecords": 10
}
```

2. Search specific meeting types:
```json
{
  "nameOfMeeting": "文部科学委員会",
  "nameOfHouse": "衆議院"
}
```

3. Search with pagination:
```json
{
  "any": "環境",
  "startRecord": 11,
  "maximumRecords": 20
}
```

## Parameters

- `any`: Search term for speech content
- `nameOfMeeting`: Meeting name filter
- `maximumRecords`: Max records (1-100, default: 30)
- `recordPacking`: Format ('xml' or 'json', default: 'xml')
- `startRecord`: Starting position for pagination
- `sessionFrom/sessionTo`: Session number range
- `nameOfHouse`: House filter (衆議院/参議院/両院協議会)
- `issueFrom/issueTo`: Issue number range

## Running

```bash
npm start
```

The server runs on stdio and can be integrated with MCP-compatible clients.