Senado Br MCP

参议院-br-mcp

巴西联邦参议院开放数据（立法者、法案、投票、委员会）的MCP服务器。

MCP（模型上下文协议）服务器，允许结构化访问巴西联邦参议院的开放数据，通过人工智能对话实现对立法信息的民主化。

特性

• 33工具 用于访问参议院数据
• 来自官方API的实时数据
• 电子公民融合：通过网络抓取公民参与数据
• 结构化JSON响应
• 使用可操作建议处理错误
• 具有完全类型安全的TypeScript
• 两种访问模式： stdio（npm）和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桌面配置

添加到您的 claude_desktop_config.json:

窗户： %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桌面配置

在克劳德桌面设置中，转到 “添加自定义连接器” 并输入：

• 姓名： 参议院-br-mcp
• 网址： https://senado-br-mcp.up.railway.app/mcp

端点

速率限制

HTTP服务器每月有一个请求限制，以保持在免费层内：

• 警报以50%、80%和100%的使用率发送
• 当达到限制时，请使用npm版本
• 每月1日限额重置

可用工具

参议员（Senadores）

立法事项（Legislative Matters）

投票（Votes）

委员会（Committees）

议程

查找/辅助（辅助）

e-Cidadania（公民参与）

访问e-Cidadania数据的工具-参议院的公民参与平台。

公共咨询（公共咨询）

立法思想（Legislative Ideas）

互动活动（Eventos Interativos）

分析工具

注： e-Cidadania工具使用具有速率限制和缓存的网络抓取。如果e-Cidadania网站暂时不可用，API工具（参议员、法案、投票）仍在运行。

使用示例

圣保罗参议员名单

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检查员进行测试

npm run inspect

______________________________________________________________________

自托管HTTP服务器

您可以托管自己的HTTP服务器实例。

本地

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

铁路

1. 分叉此存储库
2. 将Railway连接到您的GitHub
3. 部署（自动检测来自的配置 railway.json)
4. 设置环境变量：

- MONTHLY_REQUEST_LIMIT （默认值：10000） - ALERT_WEBHOOK_URL （可选，用于通知）

环境变量

数据源

API官方

• API: 联邦参议院 - 开放数据
• 文档:https://legis.senado.leg.br/dadosabertos/docs/
• 格式：JSON
• 认证：无（公共数据）

网页抓取（Web Scraping）

• 网站: 电子 公民
• 内容：公众咨询、立法构想、互动活动
• 方法：具有速率限制（1个要求/秒）和缓存（15分钟-24小时）的HTML抓取
• 后备方案：如果e-Cidadania不可用，API工具将继续工作

比尔类型（Bill Types）

宪法修正案（Constitutional Amendment） 《普通法案》（Ordinary Law Bill） 《补充法案》（Complementary Law Bill） MPV 临时措施 PDL 立法法令草案 Legislative Decree Bill 参议院决议草案（Senate Resolution Bill） 众议院法案（Chamber of Deputies Bill）

许可证

麻省理工学院

作者

西德尼·达席尔瓦·佩雷拉·比索利

仓库

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

贡献

欢迎投稿！请随时提交拉取请求。

更新日志

1.1.0

• 添加了e-Cidadania集成（11个新工具）
• 具有速率限制和缓存的Web抓取基础架构
• 公众咨询分析（两极分化/共识）
• 立法思路跟踪
• 交互式事件监控
• 调查主题建议工具

1.0.0

• 初始版本
• 22种参议院数据访问工具
• 参议员、法案、投票、委员会、议程和查找工具