Mcp Brasil

io.github.viniciusmdoobmv0.2.0更新于 Oct 8, 2026

Dados brasileiros para agentes de IA: CEP, CNPJ, bancos, taxas, feriados, clima e FIPE.

已验证Streamable HTTP可网页运行Location & LifestyleFinanceBusiness & Commerce

概览

AI 生成的概览

让助手查询巴西公共数据:邮政编码、企业登记、银行、利率、节假日、天气和 FIPE 车辆价格。

功能
提供八个查询工具,数据来自巴西公共 API。lookup_cep 由邮政编码返回完整地址,buscar_cep 由街道、城市和州反查邮政编码,lookup_cnpj 返回公司名称、登记状态、CNAE 和注册资本,lookup_banco 由银行代码返回银行名称。此外还提供当前 SELIC、CDI 和 IPCA 利率、任意年份的全国节假日、任意城市的当前气温,以及 FIPE 车辆品牌、型号和价格。
适用场景
当助手需要一次性获取巴西地址、企业、银行、经济指标、节假日、天气或车辆价格数据,而不想去抓取带验证码和广告的网站时适用。适合巴西相关任务,例如核验供应商的 CNPJ、由邮政编码补全地址或查询节假日日期。
运行要求
可作为远程 HTTP 端点运行,也可在本地用 Node.js 18+ 运行:node index.js(stdio)或 node web.js(HTTP)。README 中托管端点使用 Authorization 请求头中的 bearer 令牌,本地 Web 模式使用 API_KEY_MCP 变量,PORT 设置本地端口。未提及账号或注册。
安装前请注意
README 以明文公布了托管端点的 bearer 令牌,应视为共享而非私密。本地 Web 模式下若未设置 API_KEY_MCP,服务器将不带认证运行,README 称仅限本地测试。查询会发送给第三方公共 API(ViaCEP、BrasilAPI、Open-Meteo)。所有工具均为只读查询。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Brasil,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "mcp-brasil": {
      "type": "http",
      "url": "https://mcp-brasil-fvll.onrender.com/mcp"
    }
  }
}

README

mcp-brasil

CEP, CNPJ e mais 6 consultas brasileiras, direto no seu agente de IA. Sem site, sem anúncio, sem captcha.

Ferramentas de dados brasileiros para agentes de IA, via Model Context Protocol (MCP). O que o brasileiro consulta toda semana — endereço, empresa, banco, taxas, feriados, clima, preço de carro — disponível como ferramenta que Claude, ChatGPT, OpenClaude e qualquer cliente MCP podem chamar diretamente.

Ferramentas

FerramentaO que fazFonte
lookup_cepEndereço completo a partir do CEPViaCEP
buscar_cepEncontra o CEP pelo nome da rua + cidade + UFViaCEP
lookup_cnpjRazão social, situação cadastral, CNAE, capital socialBrasilAPI
lookup_bancoNome do banco pelo código (260 → Nubank)BrasilAPI
taxasSELIC, CDI e IPCA atuaisBrasilAPI
feriadosFeriados nacionais de qualquer anoBrasilAPI
climaTemperatura atual de qualquer cidade do mundoOpen-Meteo
fipeMarcas, modelos e preços da tabela FIPEBrasilAPI

Como usar

Remoto (HTTP — recomendado)

Endpoint público: https://mcp-brasil-fvll.onrender.com/mcp

Chave de API (uso livre durante a fase de validação):

sk-brasil-aa51f66d1b9de3dad09ee61d71099b3c

Aponte seu cliente MCP:

json
{  "mcpServers": {    "mcp-brasil": {      "type": "http",      "url": "https://mcp-brasil-fvll.onrender.com/mcp",      "headers": {        "Authorization": "Bearer sk-brasil-aa51f66d1b9de3dad09ee61d71099b3c"      }    }  }}

Local (stdio)

json
{  "mcpServers": {    "mcp-brasil": {      "command": "node",      "args": ["caminho/para/mcp-brasil/index.js"]    }  }}

Depois é só conversar:

"Qual o endereço do CEP 45822-622?" "O CNPJ 27.865.757/0001-79 está ativo?" "Qual o CEP da Rua Joana Angélica em Eunápolis?" "Faz frio em Gramado agora?"

Instalação

Requisitos: Node.js 18+.

bash
npm installnode index.js   # modo local (stdio)node web.js     # modo servidor web (HTTP)

Variáveis de ambiente do modo web:

VariávelFunção
PORTPorta do servidor (padrão 3000)
API_KEY_MCPChave exigida no cabeçalho Authorization: Bearer <chave>. Sem ela, o servidor roda sem segurança (só para teste local)

Testando sem cliente MCP

bash
node testar.js cep 01310100node testar.js clima "São Paulo"node testar.js cnpj 27865757000102node testar.js buscarcep "Joana Angelica" Eunapolis BA

Por que existe

As consultas brasileiras hoje vivem em sites com captcha, pop-up de assinatura e anúncio — feitos para humanos com paciência. Agentes de IA não clicam em anúncio nem resolvem captcha; precisam do dado limpo, em uma chamada. Este servidor é o "garçom": a IA pede, ele busca na fonte pública e entrega, 24h, sem tela nenhuma.

Todas as fontes são APIs públicas e gratuitas (ViaCEP, BrasilAPI, Open-Meteo). Sem cadastro, sem coleta de dados do usuário.

Licença

MIT

来源:README.md,提交 e3c2034

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.2.0最新Oct 8, 2026