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