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 & LifestyleBusiness & CommerceFinance

概覽

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