Senado Br MCP

🚀 senado-br-mcp

ブラジル連邦上院の公開データ（議員、法案、投票、委員会）にアクセスするためのMCPサーバーです。これにより、AIとの会話を通じて立法情報へのアクセスを民主化し、構造化されたデータにアクセスできます。

✨ 主な機能

• 上院データにアクセスするための33のツール
• 公式APIからのリアルタイムデータ
• e-Cidadania統合：ウェブスクレイピングによる市民参加データ
• 構造化されたJSONレスポンス
• アクション可能な提案を伴うエラーハンドリング
• 完全な型安全性を持つTypeScript
• 2つのアクセスモード：stdio（npm）とHTTPリモート

📦 インストール

2つの使用方法

両方のモードで同じ33のツールにアクセスできます。

オプション1: stdio/npm (ローカル)

インストール

npxを使用する（推奨）:

npx senado-br-mcp

グローバルインストール:

npm install -g senado-br-mcp
senado-br-mcp

ソースからインストール:

git clone https://github.com/SidneyBissoli/senado-br-mcp.git
cd senado-br-mcp
npm install
npm run build
npm start

Claude Desktopの設定

claude_desktop_config.jsonに追加します。

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "senado-br-mcp": {
      "command": "npx",
      "args": ["-y", "senado-br-mcp"]
    }
  }
}

オプション2: HTTPリモート (クラウド)

インストールは不要です。URLを介して直接接続できます。

Claude Desktopの設定

Claude Desktopの設定で、"カスタムコネクタの追加" を選択し、以下を入力します。

• 名前: senado-br-mcp
• URL: https://senado-br-mcp.up.railway.app/mcp

エンドポイント

レート制限

HTTPサーバーには無料枠内に収まるための月次リクエスト制限があります。

• 使用率が50%、80%、100%に達したときにアラートが送信されます。
• 制限に達した場合は、npmバージョンを使用してください。
• 制限は毎月1日にリセットされます。

💻 使用例

サンパウロ州の上院議員を一覧表示

senado_listar_senadoresを使用し、uf: "SP" を指定します。

2024年の憲法改正案を検索

senado_buscar_materiasを使用し、sigla: "PEC", ano: 2024 を指定します。

最近の投票を取得

senado_votacoes_recentesを使用し、dias: 7 を指定します。

名前で上院議員を検索

senado_buscar_senador_por_nomeを使用し、nome: "Randolfe" を指定します。

CCJ委員会のメンバーを取得

senado_membros_comissaoを使用し、sigla: "CCJ" を指定します。

二極化した公開コンサルテーションを取得

senado_ecidadania_consultas_polarizadasを使用し、minimoVotos: 5000 を指定します。

最も支持されている市民のアイデアを取得

senado_ecidadania_ideias_popularesを使用し、limite: 5 を指定します。

今後のインタラクティブなイベントを検索

senado_ecidadania_listar_eventosを使用し、status: "agendado" を指定します。

📚 詳細ドキュメント

利用可能なツール

上院議員 (Senadores)

立法案件 (Matérias)

投票 (Votações)

委員会 (Comissões)

議事日程 (Agenda)

検索/補助 (Auxiliares)

e-Cidadania (市民参加)

上院の市民参加プラットフォームであるe-Cidadaniaのデータにアクセスするためのツールです。

公開コンサルテーション (Consultas Públicas)

立法アイデア (Ideias Legislativas)

インタラクティブなイベント (Eventos Interativos)

分析ツール

⚠️ 重要な注意

e-Cidadaniaのツールは、レート制限とキャッシュを伴うウェブスクレイピングを使用しています。e-Cidadaniaのウェブサイトが一時的に利用できない場合でも、APIツール（上院議員、法案、投票）は引き続き動作します。

レスポンス形式

すべてのツールは構造化されたJSONレスポンスを返します。

成功レスポンス

{
  "success": true,
  "data": { ... },
  "metadata": {
    "fonte": "Senado Federal - Dados Abertos",
    "dataConsulta": "2024-01-15T10:30:00Z",
    "endpoint": "/senador/lista/atual"
  }
}

エラーレスポンス

{
  "success": false,
  "error": {
    "code": "SENADOR_NAO_ENCONTRADO",
    "message": "Senator with code 99999 was not found",
    "suggestion": "Use senado_buscar_senador_por_nome to find the correct code"
  }
}

🔧 技術詳細

開発

前提条件

• Node.js 18+
• npm

セットアップ

npm install

ビルド

# stdioバージョン（npmパッケージ）をビルド
npm run build

# HTTPサーバーバージョンをビルド
npm run build:server

# 両方をビルド
npm run build:all

開発モード

# stdioモード
npm run dev

# HTTPサーバーモード
npm run dev:server

型チェック

npm run typecheck

MCPインスペクターでテスト

npm run inspect

HTTPサーバーの自前ホスティング

独自のHTTPサーバーインスタンスをホストすることができます。

ローカル

npm run build:server
npm run start:server
# サーバーは http://localhost:3000 で実行されます。

Railway

1. このリポジトリをフォークします。
2. RailwayをGitHubに接続します。
3. デプロイします（railway.jsonから設定を自動検出します）。
4. 環境変数を設定します。
   • MONTHLY_REQUEST_LIMIT (デフォルト: 10000)
   • ALERT_WEBHOOK_URL (オプション、通知用)

環境変数

データソース

公式API

• API: Senado Federal - Dados Abertos
• ドキュメント: https://legis.senado.leg.br/dadosabertos/docs/
• 形式: JSON
• 認証: 不要（公開データ）

e-Cidadania (ウェブスクレイピング)

• ウェブサイト: e-Cidadania
• 内容: 公開コンサルテーション、立法アイデア、インタラクティブなイベント
• 方法: レート制限（1リクエスト/秒）とキャッシュ（15分 - 24時間）を伴うHTMLスクレイピング
• フォールバック: e-Cidadaniaが利用できない場合でも、APIツールは引き続き動作します。

法案の種類 (Tipos de Matéria)

📄 ライセンス

MIT

作者

Sidney da Silva Pereira Bissoli

リポジトリ

https://github.com/SidneyBissoli/senado-br-mcp

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

変更履歴

1.1.0

• e-Cidadania統合を追加（11の新しいツール）
• レート制限とキャッシュを伴うウェブスクレイピングインフラストラクチャ
• 公開コンサルテーションの分析（二極化/合意的）
• 立法アイデアの追跡
• インタラクティブなイベントの監視
• 調査トピック提案ツール

1.0.0

• 初期リリース
• 上院データにアクセスするための22のツール
• 上院議員、法案、投票、委員会、議事日程、検索ツール