mcp-server-brasil

Servidor MCP com ferramentas brasileiras: CNPJ, CEP e cotação de moedas.

---

Por que eu fiz isso?

Cansado de ficar catando API brasileira na mão. Sério, toda vez que eu precisava consultar CNPJ num projeto freelancer, perdia uns 30 min configurando o fetch, tratando as respostas da ReceitaWS, lidando com o rate limit que ela tem... aí quando pensava que tava tudo certo, o CNPJ tinha ponto e vírgula e a API devolvia erro.

Então decidi montar um server MCP que faça isso tudo de uma vez, sem eu precisar lembrar que a ReceitaWS limita a 5 requests por minuto e dá timeout de graça.

O claude desktop agora resolve isso chamando uma ferramenta simples.

---

O que ele faz

Basicamente é um MCP server que expõe essas 3 ferramentas:

consulta_cnpj

Consulta CNPJ e devolve:

• Razão social, nome fantasia, situação cadastral
• Capital social, atividade principal
• Endereço completo
• Sócios e suas qualificações

{
  "cnpj": "00.000.000/0001-91"
}

consulta_cep

Busca endereço pelo CEP. Aceita com ou sem hífen, porque ninguém quer lembrar se põe ou não.

{
  "cep": "01001-000"
}

cotacao_dolar

Devolve cotação atual do dólar e do euro em relação ao real. Sem parâmetros, é só chamar.

---

Instalação

Você precisa do Node 18+.

git clone https://github.com/seu-usuario/mcp-server-brasil.git
cd mcp-server-brasil
npm install
npm run build

Pronto.

---

Usando com Claude Desktop

Edite o claude_desktop_config.json:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

Exemplo de config:

{
  "mcpServers": {
    "brasil": {
      "command": "node",
      "args": [
        "/caminho/completo/ate/mcp-server-brasil/dist/index.js"
      ]
    }
  }
}

Pode ser via npx também, se publicar no npm:

{
  "mcpServers": {
    "brasil": {
      "command": "npx",
      "args": ["mcp-server-brasil"]
    }
  }
}

---

Exemplos de retorno

CNPJ:

{
  "cnpj": "00.000.000/0001-91",
  "razao_social": "EMPRESA EXEMPLO LTDA",
  "nome_fantasia": "EXEMPLO",
  "situacao": "ATIVA",
  "capital_social": "R$ 1.000.000,00",
  "atividade_principal": "Comércio de Exemplo",
  "endereco": {
    "logradouro": "Rua Exemplo",
    "numero": "123",
    "cidade": "São Paulo",
    "estado": "SP",
    "cep": "01000-000"
  },
  "sociedades": [
    { "nome": "João Silva", "qualificacao": "Sócio-Administrador" }
  ]
}

CEP:

{
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "complemento": "lado ímpar",
  "bairro": "Sé",
  "cidade": "São Paulo",
  "estado": "São Paulo",
  "uf": "SP",
  "ibge": "3550308",
  "ddd": "11"
}

Cotação:

{
  "dolar": {
    "moeda": "USD/BRL",
    "compra": 5.05,
    "venda": 5.06,
    "alta": 5.11,
    "baixa": 5.04,
    "variacao": -0.47,
    "atualizado_em": "01/01/2024, 15:30:00"
  },
  "euro": {
    "moeda": "EUR/BRL",
    "compra": 5.45,
    "venda": 5.46,
    "alta": 5.51,
    "baixa": 5.45,
    "variacao": 0.12,
    "atualizado_em": "01/01/2024, 15:30:00"
  }
}

---

Roadmap

• Cache in-memory pra evitar rate limit da ReceitaWS
• Consulta de CPF (com token apropriado, talvez)
• Consulta de placas de veículo via API
• Docker pra facilitar deploy
• Testes unitários (quando der tempo)

---

Quem fez

Feito por mim, mais ou menos no desespero de não querer copiar 'n paste a mesma função de consulta de CNPJ pela 15ª vez.

Se quiser adicionar uma API nova, manda um PR que eu reviso rapidinho.

---

Licença

MIT. Use à vontade, só não cobre por ele e fale que fez sozinho :P