senado-br-mcp - 支持33個工具訪問巴西參議院公開數據，支持npm和HTTP兩用的MCP集成工具

探索

Senado Br MCP

巴西參議院MCP服務器，提供33個工具訪問參議院公開數據（議員、法案、投票、委員會）和公民參與平臺，支持npm本地和HTTP遠程兩種使用方式。

研究與數據法律與合規 #巴西參議院 #立法數據 #公民參與 #MCP服務 .TypeScript

評分 : 2分

下載量 : 4.2K

更新時間 : 2026-03-13

打開站點

什麼是Senado BR MCP?

Senado BR MCP是一個專門用於訪問巴西聯邦參議院公開數據的工具。它通過Model Context Protocol（MCP）協議，讓AI助手（如Claude）能夠直接查詢巴西參議院的最新信息，包括議員資料、法案進展、投票記錄、委員會活動等。該工具旨在讓普通公民、記者、研究人員和學生都能輕鬆獲取立法信息，促進政府透明度。

如何使用Senado BR MCP?

您可以通過兩種方式使用：1) 本地安裝（適合技術人員），通過Claude Desktop配置後直接使用；2) 雲端訪問（適合非技術人員），無需安裝，直接通過URL連接。兩種方式都提供相同的33個查詢工具。

適用場景

• 記者報道立法新聞時核實信息 • 研究人員分析立法趨勢和投票模式 • 公民瞭解議員履職情況和法案進展 • 學生研究巴西政治制度和立法過程 • 社會組織監督政府透明度和公民參與

主要功能

全面的數據覆蓋

提供33個查詢工具，覆蓋參議員信息、法案追蹤、投票記錄、委員會活動、議程安排等所有主要立法數據領域。

e-Cidadania公民參與數據

獨家整合巴西參議院e-Cidadania平臺數據，包括公眾諮詢、立法建議、互動活動等公民參與信息。

雙模式訪問

支持本地安裝和雲端訪問兩種方式，滿足不同技術水平的用戶需求。雲端訪問無需安裝任何軟件。

即時數據更新

直接從巴西參議院官方API獲取最新數據，確保信息的時效性和準確性。

結構化JSON響應

所有查詢返回標準化的JSON格式數據，便於程序處理和前端展示，包含成功/錯誤狀態和元數據。

智能錯誤處理

當查詢出錯時，不僅返回錯誤信息，還提供具體的解決建議和替代查詢方法。

公民參與分析

提供專門工具分析公眾諮詢的投票傾向（極化或共識），識別社會關注的熱點議題。

優勢

完全免費使用，基於巴西參議院公開數據

無需編程知識，通過自然語言對話即可查詢

兩種訪問方式滿足不同用戶需求

數據來源權威，直接來自官方API

包含獨特的公民參與數據，其他平臺少有

響應速度快，查詢結果即時返回

支持複雜的過濾和搜索條件

侷限性

雲端版本有每月請求次數限制（免費版）

e-Cidadania數據依賴網頁抓取，可能偶爾延遲

僅覆蓋聯邦參議院數據，不包括眾議院

需要Claude AI助手才能使用（不支持其他AI）

部分歷史數據可能不完整，取決於官方API

技術術語較多，非政治專業人士可能需要學習

如何使用

選擇訪問方式

根據您的技術能力選擇：技術人員推薦本地安裝，非技術人員推薦雲端訪問。

配置Claude Desktop

打開Claude Desktop設置，添加MCP服務器配置。本地安裝需要指定npx命令，雲端訪問只需輸入URL。

開始對話查詢

在Claude對話中，直接詢問巴西參議院相關信息，Claude會自動使用合適的工具查詢。

使用高級查詢

可以指定更精確的查詢條件，如時間範圍、法案類型、政黨過濾等。

使用案例

記者報道立法新聞

記者需要報道一項重要法案的進展，查詢法案詳情、提案人、審議狀態和投票記錄。

公民監督議員履職

公民想了解自己所在州的參議員近期投票記錄和出席情況。

研究人員分析立法趨勢

政治學研究人員需要分析某一政策領域的立法活動趨勢。

社會組織促進公民參與

社會組織想了解公民對某項立法議題的意見，通過e-Cidadania平臺數據。

學生了解立法程序

法律系學生需要了解一項法案從提出到成為法律的完整流程。

常見問題

我需要付費使用這個服務嗎？

雲端訪問有次數限制嗎？

數據更新頻率如何？

我需要懂葡萄牙語才能使用嗎？

這個工具包含眾議院的數據嗎？

如何獲取歷史數據？

e-Cidadania數據可靠嗎？

我可以在自己的應用中集成這個工具嗎？

查詢出錯時怎麼辦？

如何獲取特定議員的聯繫方式？

🚀 巴西聯邦參議院MCP服務器

本項目是一個MCP（模型上下文協議）服務器，可對巴西聯邦參議院的開放數據（包括立法者、法案、投票、委員會等信息）進行結構化訪問。通過與人工智能對話，它讓立法信息的獲取變得更加民主。

🚀 快速開始

該項目提供了兩種使用模式，分別為stdio/npm（本地）和HTTP遠程（雲端），兩種模式均可訪問33種工具。

✨ 主要特性

33種工具：用於訪問參議院數據。
即時數據：數據來源於官方API。
e-Cidadania集成：通過網頁抓取獲取公民參與數據。
結構化JSON響應：方便數據處理。
錯誤處理：提供可操作的建議。
TypeScript編寫：具備完整的類型安全。
兩種訪問模式：stdio（npm）和HTTP遠程。

📦 安裝指南

Option 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桌面配置

將以下內容添加到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"]
    }
  }
}

Option 2: HTTP遠程（雲端）

無需安裝，可直接通過URL連接。

Claude桌面配置

在Claude桌面設置中，點擊**"添加自定義連接器"**，並輸入以下信息：

名稱：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號重置。

💻 使用示例

列出聖保羅州的參議員

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"

📚 詳細文檔

可用工具

參議員（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`	獲取法案文本（原始、替代、最終）及下載鏈接
`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輔助分析建議月度調查主題

響應格式

所有工具均返回結構化的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

分叉此倉庫。
將Railway連接到你的GitHub。
部署（自動從railway.json檢測配置）。
設置環境變量：
- 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
內容：公眾諮詢、立法提案、互動活動
方法：HTML抓取，有速率限制（1請求/秒）和緩存（15分鐘 - 24小時）
備用方案：如果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	眾議院法案