MCP CNPJ Intelligence

MCP CNPJ Intelligence

MCP Server para consulta de 27 milhoes de empresas brasileiras da Receita Federal.

Integre dados de CNPJs diretamente no Claude Desktop, Cursor, ou qualquer cliente MCP.

Instalacao Rapida

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "cnpj": {
      "command": "npx",
      "args": ["-y", "mcp-cnpj-intelligence"]
    }
  }
}

Localizacao do arquivo:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Cursor / VS Code

Adicione ao arquivo de configuracao MCP:

{
  "mcpServers": {
    "cnpj": {
      "command": "npx",
      "args": ["-y", "mcp-cnpj-intelligence"]
    }
  }
}

Ferramentas Disponiveis

Consulta Basica

Busca e Descoberta

Analise e Benchmark

Estatisticas

Exemplos de Uso

No Claude Desktop

Busque informacoes da empresa com CNPJ 00.000.000/0001-91

Liste as 10 maiores industrias de embalagens plasticas em SP

Encontre empresas similares a CNPJ 12345678 com score minimo de 60

Quais empresas do setor de supermercados estao no CEP 01310-100?

CNAEs Comuns

• 4711302 - Supermercados
• 5611201 - Restaurantes
• 2222600 - Embalagens plasticas
• 1733800 - Embalagens papelao
• 4751201 - Comercio de informatica
• 6201501 - Desenvolvimento de software

API Publica

Este MCP consome a API publica:

https://api-cnpj.sdebot.top

Nao requer autenticacao. Rate limit: 60 req/min.

Desenvolvimento Local

# Clone o repositorio
git clone https://github.com/setor-embalagem/mcp-cnpj-intelligence.git
cd mcp-cnpj-intelligence

# Instale dependencias
npm install

# Rode em modo desenvolvimento
npm run dev

# Rode testes
npm test

# Build para producao
npm run build

Estrutura do Projeto

mcp-cnpj-intelligence/
├── src/
│   └── index.ts          # Servidor MCP
├── tests/
│   └── golden-path.test.ts
├── docs/
│   └── adr/              # Architecture Decision Records
├── .github/
│   └── workflows/
│       └── ci.yml        # CI/CD
├── package.json
├── tsconfig.json
└── README.md

Contribuindo

1. Fork o repositorio
2. Crie uma branch: git checkout -b feature/nova-funcionalidade
3. Commit: git commit -m 'feat: adiciona nova funcionalidade'
4. Push: git push origin feature/nova-funcionalidade
5. Abra um Pull Request

License

MIT - Setor da Embalagem 2024

Links

• API Documentacao
• MCP Protocol