lgpd-mcp
Servidor MCP (Model Context Protocol) para auxiliar organizações e desenvolvedores na conformidade com a Lei Geral de Proteção de Dados Pessoais (LGPD - Lei 13.709/2018).
Recursos
- 9 ferramentas para validação de bases legais, consentimento, modelos de documentos, PIA, checklist, políticas, direitos do titular, mapeamento de dados sensíveis e avaliação de risco
- 5 recursos de referência: fundamentos, artigos, bases legais, glossário e ANPD
- 4 prompts para revisão de política, resposta ao titular, avaliação de cenário e documentação
Requisitos
- Node.js 18+
- pnpm, npm ou yarn
Instalação
Via npm (recomendado)
npx @lordmendes/lgpd-mcp
Ou instale globalmente:
npm install -g @lordmendes/lgpd-mcp
lgpd-mcp
Via repositório
git clone https://github.com/LordMendes/lgpd-mcp.git
cd lgpd-mcp
# Instale as dependências
pnpm install
# ou: npm install
# ou: yarn install
# Compile o projeto (obrigatório para produção)
pnpm build
Uso
Modo stdio (padrão)
O servidor é executado via stdio e espera conexões de clientes MCP (Cursor, Claude Desktop, etc.):
# Se instalado via npm
npx @lordmendes/lgpd-mcp
# Desenvolvimento local
npx tsx src/index.ts
Modo HTTP (remoto)
Para execução como servidor HTTP (uso remoto):
pnpm start:http
# ou: npx tsx src/http.ts
O servidor HTTP escuta na porta definida por MCP_PORT (padrão: 3000). Endpoint: POST /mcp. Consulte docs/HTTP.md para detalhes de integração.
Teste com MCP Inspector
pnpm test:mcp
# ou: npx @modelcontextprotocol/inspector npx tsx src/index.ts
Configuração
Cursor
Veja docs/CURSOR.md para instruções detalhadas de configuração no Cursor.
Claude Desktop
Veja docs/CLAUDE_DESKTOP.md para instruções de configuração no Claude Desktop.
Variáveis de ambiente
| Variável | Descrição | Padrão |
|---|---|---|
MCP_PORT | Porta do servidor HTTP (modo remoto) | 3000 |
Consulte .env.example para referência.
Documentação
- Publicação (Publishing) — como publicar no npm e MCP Registry
- Ferramentas (Tools) — descrição de cada tool
- Recursos (Resources) — descrição de cada resource
- Prompts — descrição de cada prompt
- Configuração Cursor — instruções para Cursor
- Configuração Claude Desktop — instruções para Claude Desktop
- Transporte HTTP — uso remoto via HTTP
- Aviso Legal — não substitui assessoria jurídica
- Segurança — práticas de segurança do projeto
Scripts
| Script | Descrição |
|---|---|
pnpm dev | Executa o servidor em modo desenvolvimento |
pnpm start | Executa o servidor compilado |
pnpm build | Compila TypeScript |
pnpm test | Executa testes unitários |
pnpm lint | Verifica código com ESLint |
pnpm format | Formata código com Prettier |
Aviso importante
Todas as ferramentas são auxiliares e não substituem assessoria jurídica especializada. Consulte sempre um advogado ou consultor em proteção de dados para decisões jurídicas. Para orientações oficiais, acesse a ANPD.
Licença
MIT