senado-br-mcp

⚠️ 非推奨 — このリポジトリは移転しました

このサーバーはここではメンテナンスされていません。 ブラジル上院 MCP サーバーは現在、 senado-br-mcp-cloudflare に移転しています。66 個のツールを備え、 レベル 1 の出典情報を含み、ホスト版（https://senado.sidneybissoli.com/mcp、セットアップ不要）と npm/stdio（npx senado-br-mcp、v3.x）の両方で利用できます。npm パッケージ senado-br-mcp は現在、この サーバーを公開しています（v3.2.1 以降）。ここにある < 3.0.0 のバージョンは非推奨です。移行してください。このリポジトリはアーカイブされています。

---

Senado Brasil MCP Server

🇧🇷 ポルトガル語で読む

ブラジル連邦上院のオープンデータ（議員、法案、投票、委員会）にアクセスするための MCP サーバーです。

AI との会話を通じて、ブラジル連邦上院のオープンデータに構造化された形でアクセスできる MCP（Model Context Protocol）サーバーです。立法情報へのアクセスを誰もが利用できるようにします。

動作例

アシスタントに、ポルトガル語で普通に質問できます。

• 「現職の SP 州選出上院議員を一覧表示して。」 → senado_listar_senadores
• 「PEC 45/2019 の審議経過を表示して。」 → senado_buscar_materias + senado_obter_materia
• 「e-Cidadania で公開中の、最も支持されている立法アイデアは？」 → senado_ecidadania_listar_ideias

回答は上院の公式オープンデータ API からリアルタイムで取得されます。学習データから推測した数字ではなく、出典情報を備えた実データです。

機能

• 上院データにアクセスするための33 個のツール
• 公式 API からリアルタイムでデータを取得
• **e-Cidadania 連携：**ウェブスクレイピングによる市民参加データ
• 構造化された JSON レスポンス
• 実行可能な提案を含むエラー処理
• TypeScript による完全な型安全性
• **2 つのアクセスモード：**stdio（npm）と HTTP リモート

2 つの利用方法

モード	インストール	適した用途
stdio/npm	npx senado-br-mcp	技術者、ローカルでの利用
HTTP リモート	不要	非技術者、クラウドアクセス

どちらのモードでも、同じ 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 の設定で 「Add Custom Connector」 を選び、次の情報を入力します。

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

エンドポイント

エンドポイント	説明
GET /	サーバー情報とドキュメント
GET /health	ヘルスチェック
GET /stats	使用統計
POST /mcp	MCP プロトコルのエンドポイント

レート制限

HTTP サーバーには、無料枠内で利用できるよう、月間リクエスト上限が設定されています。

• 使用率が 50%、80%、100% に達すると通知が送信されます
• 上限に達した場合は、代わりに npm 版を使用してください
• 上限は毎月 1 日にリセットされます

利用可能なツール

上院議員（Senadores）

ツール	説明
senado_listar_senadores	現職または任期別に上院議員を一覧表示します。フィルター：州（UF）、政党
senado_obter_senador	上院議員の詳細情報（経歴、任期、委員会）を取得します
senado_buscar_senador_por_nome	名前で上院議員を検索します
senado_votacoes_senador	上院議員の投票内容を一覧表示します。フィルター：年、期間

立法案件（Matérias）

ツール	説明
senado_buscar_materias	種類（PEC、PL、PLP、MPV）、番号、年、キーワード、提案者で法案を検索します
senado_obter_materia	法案の詳細（要約、提案者、状況、報告者）を取得します
senado_tramitacao_materia	法案の審議経過を取得します
senado_textos_materia	法案の本文（原案、代替案、最終版）をダウンロード URL とともに取得します
senado_votos_materia	法案の投票結果を取得します

投票（Votações）

ツール	説明
senado_listar_votacoes	年別に本会議の投票を一覧表示します。フィルター：月、期間
senado_obter_votacao	上院議員別の記名投票を含む投票の詳細を取得します
senado_votacoes_recentes	最近の投票を取得します（直近 N 日間）

委員会（Comissões）

ツール	説明
senado_listar_comissoes	委員会を一覧表示します。フィルター：種類（常設、臨時、CPI）、活動中
senado_obter_comissao	委員会の詳細（委員長、副委員長、目的）を取得します
senado_membros_comissao	役職を含め、委員会のメンバーを一覧表示します
senado_reunioes_comissao	議題を含め、委員会の会議を一覧表示します

議事日程

ツール	説明
senado_agenda_plenario	投票議題を含む本会議の日程を取得します
senado_agenda_comissoes	委員会の会議日程を取得します

検索／補助（Auxiliares）

ツール	説明
senado_legislatura_atual	現在の任期の情報（番号、期間、日付）を取得します
senado_tipos_materia	有効な法案の種類（PEC、PL、PLP、MPV など）を一覧表示します
senado_partidos	上院議員数とともに政党を一覧表示します
senado_ufs	上院議員数とともに州を一覧表示します

e-Cidadania（市民参加）

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

公開協議（Consultas Públicas）

ツール	説明
senado_ecidadania_listar_consultas	審議中の法案に対する市民投票を含む公開協議を一覧表示します
senado_ecidadania_obter_consulta	投票、提案者、コメントを含む協議の詳細を取得します
senado_ecidadania_consultas_polarizadas	賛否が拮抗する協議（約50/50の投票）を取得します。意見が分かれる問題の特定に役立ちます
senado_ecidadania_consultas_consensuais	合意が見られる協議（一方が85％超）を取得します。広範な合意の特定に役立ちます

立法アイデア（Ideias Legislativas）

ツール	説明
senado_ecidadania_listar_ideias	市民が提案した立法アイデアを一覧表示します
senado_ecidadania_obter_ideia	全文の説明や法案への転換状況を含むアイデアの詳細を取得します
senado_ecidadania_ideias_populares	最も支持されている立法アイデアを取得します

インタラクティブイベント（Eventos Interativos）

ツール	説明
senado_ecidadania_listar_eventos	公聴会、承認審査、ライブ配信などのインタラクティブイベントを一覧表示します
senado_ecidadania_obter_evento	議題、ゲスト、動画リンクを含むイベントの詳細を取得します
senado_ecidadania_eventos_populares	市民からのコメントや質問が最も多いイベントを取得します

分析ツール

ツール	説明
senado_ecidadania_sugerir_tema_enquete	参加状況の指標に基づき、月例調査のテーマを提案する AI 支援分析を行います

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

使用例

São Paulo州の上院議員を一覧表示する

Use senado_listar_senadores with uf: "SP"

2024年の憲法改正を検索する

Use senado_buscar_materias with sigla: "PEC", ano: 2024

最近の投票を取得する

Use senado_votacoes_recentes with dias: 7

名前で上院議員を検索する

Use senado_buscar_senador_por_nome with nome: "Randolfe"

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

Use senado_membros_comissao with sigla: "CCJ"

意見が二極化している公開協議を取得する

Use senado_ecidadania_consultas_polarizadas with minimoVotos: 5000

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

Use senado_ecidadania_ideias_populares with limite: 5

今後開催されるインタラクティブイベントを検索する

Use senado_ecidadania_listar_eventos with status: "agendado"

レスポンス形式

すべてのツールは、構造化された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

ビルド

# Build stdio version (npm package)
npm run build

# Build HTTP server version
npm run build:server

# Build both
npm run build:all

開発モード

# stdio mode
npm run dev

# HTTP server mode
npm run dev:server

型チェック

npm run typecheck

MCP Inspectorでテストする

npm run inspect

---

HTTPサーバーのセルフホスティング

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

ローカル

npm run build:server
npm run start:server
# Server runs on http://localhost:3000

Railway

1. このリポジトリをフォークします
2. RailwayをGitHubに接続します
3. デプロイします（railway.jsonから設定が自動検出されます）
4. 環境変数を設定します：
   • MONTHLY_REQUEST_LIMIT（デフォルト：10000）
   • ALERT_WEBHOOK_URL（任意。通知用）

環境変数

変数	説明	デフォルト
PORT	サーバーのポート	3000
MONTHLY_REQUEST_LIMIT	月間リクエスト上限	10000
ALERT_WEBHOOK_URL	アラート用Webhook	-
LOG_LEVEL	ログレベル	info

データソース

公式API

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

e-Cidadania（ウェブスクレイピング）

• ウェブサイト：e-Cidadania
• コンテンツ：公開協議、立法に関するアイデア、インタラクティブイベント
• 方法：レート制限（1 req/sec）とキャッシュ（15min-24h）を使用したHTMLスクレイピング
• フォールバック：e-Cidadaniaが利用できない場合も、APIツールは引き続き動作します

法案の種類（Tipos de Matéria）

コード	名称	説明
PEC	Proposta de Emenda à Constituição	憲法改正案
PL	Projeto de Lei	通常法律案
PLP	Projeto de Lei Complementar	補完法案
MPV	Medida Provisória	暫定措置
PDL	Projeto de Decreto Legislativo	立法令案
PRS	Projeto de Resolução do Senado	上院決議案
PLC	Projeto de Lei da Câmara	下院法案

ライセンス

MIT

作者

Sidney da Silva Pereira Bissoli

リポジトリ

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

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

変更履歴

1.1.0

• e-Cidadaniaとの連携を追加（新しいツールを11個追加）
• レート制限とキャッシュを備えたウェブスクレイピング基盤
• 公開協議の分析（意見の二極化／合意形成）
• 立法に関するアイデアの追跡
• インタラクティブイベントのモニタリング
• アンケートのトピック提案ツール

1.0.0

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