内容
# kokkai-mcp
国会議事録検索・要約 MCP サーバー
国立国会図書館の[国会会議録検索システム API](https://kokkai.ndl.go.jp/api.html) を利用し、
発言検索・会議録取得・議事録要約を MCP ツールとして提供します。
## 機能
| ツール | 説明 |
|--------|------|
| `search_speeches` | キーワード・発言者・会議名・期間で発言を検索 |
| `get_meeting` | issueID を指定して会議録全体を取得 |
| `summarize_speeches` | 発言一覧を要約（brief / standard / detailed） |
| `summarize_meeting` | 会議録全体を取得して要約 |
## セットアップ
### 1. 依存関係のインストール
```bash
npm install
```
### 2. 環境変数の設定
```bash
cp .env.example .env
# .env を編集して ANTHROPIC_API_KEY を設定する
```
必須の環境変数:
| 変数名 | 説明 |
|--------|------|
| `ANTHROPIC_API_KEY` | Anthropic Claude API キー（https://console.anthropic.com/ で取得）|
### 3. ビルド
```bash
npm run build
```
### 4. Claude Desktop への登録
`claude_desktop_config.json` に以下を追加する:
```json
{
"mcpServers": {
"kokkai-mcp": {
"command": "node",
"args": ["/path/to/kokkai-mcp/dist/server.js"],
"env": {
"ANTHROPIC_API_KEY": "your-api-key-here"
}
}
}
}
```
## 開発
```bash
npm run dev # ホットリロード起動
npm test # テスト実行
npm run lint # Lint チェック
npm run build # ビルド
```
## 使用例
### 発言検索
```
生成AIに関する最近の国会議論を検索してください。
→ search_speeches({ query: "生成AI", from: "2024-01-01", limit: 10 })
```
### 会議録要約
```
issueID の会議録を要約してください。
→ summarize_meeting({ issueID: "...", mode: "standard" })
```
## アーキテクチャ
- Node.js 20+ / TypeScript 5.x
- MCP SDK (stdio transport)
- Anthropic Claude API（claude-3-5-haiku デフォルト）
- メモリキャッシュ（TTL: 発言 1 日、会議録・要約 7 日）
詳細は `docs/architecture/` を参照してください。
## ライセンス
本ソフトウェアの利用にあたっては、
[国会会議録検索システム利用規約](https://kokkai.ndl.go.jp/terms.html) に従うこと。
