国会議事録検索 MCP サーバー

Model Context Protocol (MCP) を使用して、国会議事録検索APIにアクセスできるサーバーです。

機能

ツール機能

• 会議単位簡易出力（search_meetings_simple）
• 会議単位出力（search_meetings_full）
• 発言単位出力（search_speeches）

プロンプト機能

AIアシスタントに国会議事録の効果的な検索方法を指示：

• search_with_urls: 発言URLを必ず含めて回答するよう指示
• search_diet_proceedings: 効率的な検索戦略のガイド
• analyze_speech_patterns: 発言パターンの分析方法
• track_legislative_progress: 法案審議の追跡方法
• find_specific_speaker: 特定発言者の検索
• search_by_topic: トピック別の議論検索

各検索結果には以下のURLが含まれます：

• speechURL: 個別発言への直接リンク
• meetingURL: 会議録全体へのリンク
• pdfURL: PDF版へのリンク（存在する場合）

インストール

通常のインストール

npm install
npm run build

Dockerを使用する場合

Docker Hubを使用（推奨）

# Docker Hubからイメージを取得
docker pull seiichi3141/kokkai-giji-mcp:latest

# コンテナを起動
docker run --rm -i seiichi3141/kokkai-giji-mcp:latest

ローカルビルド（開発時）

# Dockerイメージをビルド
docker build -t kokkai-giji-mcp .

# Docker Composeでサービス起動
docker-compose up -d

使用方法

Claude Desktop での設定

通常実行の場合

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "kokkai-giji": {
      "command": "node",
      "args": ["/path/to/mcp_kokkai_giji/dist/index.js"]
    }
  }
}

Docker Hubイメージ使用の場合

{
  "mcpServers": {
    "kokkai-giji": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "seiichi3141/kokkai-giji-mcp:latest"
      ]
    }
  }
}

ローカルDockerコンテナ使用の場合

{
  "mcpServers": {
    "kokkai-giji": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "kokkai-giji-mcp",
        "node",
        "dist/index.js"
      ]
    }
  }
}

開発・テスト用コマンド

# 開発モード（ソースコードから直接実行）
npm run dev

# テスト実行
npm test

# テスト（ウォッチモード）
npm run test:watch

# カバレッジ付きテスト
npm run test:coverage

利用可能なツール

search_meetings_simple

会議単位簡易出力。会議の基本情報と該当する発言のリストを取得（最大100件）。

search_meetings_full

会議単位出力。会議の全発言本文を含む詳細データを取得（最大10件）。

search_speeches

発言単位出力。個別の発言本文を取得（最大100件）。

共通パラメータ

• nameOfHouse: 院名（衆議院、参議院、両院、両院協議会）
• nameOfMeeting: 会議名（例：本会議、予算委員会）。半角スペース区切りでOR検索
• any: 発言内容の検索キーワード。半角スペース区切りでAND検索
• speaker: 発言者名。半角スペース区切りでOR検索
• from: 開会日付／始点（YYYY-MM-DD形式）
• until: 開会日付／終点（YYYY-MM-DD形式）
• sessionFrom: 国会回次From（開始回）
• sessionTo: 国会回次To（終了回）
• issueFrom: 号数From（開始号）
• issueTo: 号数To（終了号）
• speechNumber: 発言番号（0以上の整数）
• speakerPosition: 発言者肩書き（部分一致）
• speakerGroup: 発言者所属会派（部分一致）
• speakerRole: 発言者役割（証人、参考人、公述人）
• supplementAndAppendix: 追録・附録に限定（true/false）
• contentsAndIndex: 目次・索引に限定（true/false）
• searchRange: 検索対象箇所（冒頭、本文、冒頭・本文）
• closing: 閉会中の会議録に限定（true/false）
• speechID: 発言ID
• issueID: 会議録ID（21桁の英数字）
• maximumRecords: 最大取得件数
  • search_meetings_simple, search_speeches: 1-100（デフォルト30）
  • search_meetings_full: 1-10（デフォルト3）
• startRecord: 取得開始位置（デフォルト1）

API について

このサーバーは国立国会図書館の国会会議録検索システムAPIを使用しています。 詳細: https://kokkai.ndl.go.jp/api.html