senado-br-mcp - 支持33个工具访问巴西参议院公开数据，支持npm和HTTP两用的MCP集成工具

探索

Senado Br MCP

巴西参议院MCP服务器，提供33个工具访问参议院公开数据（议员、法案、投票、委员会）和公民参与平台，支持npm本地和HTTP远程两种使用方式。

研究与数据法律与合规 #巴西参议院 #立法数据 #公民参与 #MCP服务 .TypeScript

评分 : 2分

下载量 : 5.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	众议院法案