MCP Legal Doc Analyzer

Ferramentas MCP específicas de domínio para fluxos de trabalho de documentos jurídicos — extrair cláusulas, verificar conformidade, sinalizar riscos

GitHub
1

Documentação

Analisador de Documentos Legais MCP

Pacote npm mcp-legal-doc-analyzer

Ferramentas MCP específicas de domínio para fluxos de trabalho com documentos legais. Extraia cláusulas-chave de contratos, sinalize disposições arriscadas com base em modelos de regras configuráveis, compare versões de documentos no nível de cláusula e verifique conformidade com checklists padrão — tudo localmente, sem que os documentos saiam da sua máquina.

Referência de ferramentas | Configuração | Contribuição | Solução de problemas

Principais recursos

  • Extração de cláusulas: Identifica e rotula limites de cláusulas (rescisão, responsabilidade, propriedade intelectual, lei aplicável e outros) em arquivos PDF, DOCX e texto simples.
  • Sinalização de riscos: Verifica cláusulas extraídas contra modelos de regras YAML e retorna achados classificados por severidade.
  • Verificação de conformidade: Valida documentos contra checklists estruturados (NDA, contrato de trabalho, termos SaaS) com aprovação/reprovação por requisito.
  • Comparação de versões: Compara duas versões de um documento no nível de cláusula — não linhas de texto bruto.
  • Modelos configuráveis: Conjuntos de regras são arquivos YAML que profissionais jurídicos podem revisar e editar sem escrever código.
  • Processamento apenas local: Toda a análise e processamento ocorre no dispositivo; documentos nunca são transmitidos externamente.

Avisos legais

mcp-legal-doc-analyzer é uma ferramenta de análise, não aconselhamento jurídico. Os resultados devem ser revisados por um profissional jurídico qualificado antes de tomar decisões. A extração de cláusulas usa correspondência de padrões e heurísticas; os resultados podem ser incompletos ou incorretos para formatos de documentos não padronizados. Extrações de baixa confiança são sinalizadas explicitamente.

O conteúdo dos documentos é processado localmente e armazenado em um banco de dados SQLite local. Não compartilhe exportações do banco de dados que contenham documentos confidenciais.

Requisitos

  • Node.js v20.19 ou mais recente.
  • npm.

Primeiros passos

Adicione a seguinte configuração ao seu cliente MCP:

{
  "mcpServers": {
    "legal-analyzer": {
      "command": "npx",
      "args": ["-y", "mcp-legal-doc-analyzer@latest"]
    }
  }
}

Para carregar modelos de conformidade personalizados de um diretório:

{
  "mcpServers": {
    "legal-analyzer": {
      "command": "npx",
      "args": ["-y", "mcp-legal-doc-analyzer@latest", "--templates=~/legal/my-templates"]
    }
  }
}

Configuração do cliente MCP

Amp · Claude Code · Cline · Cursor · VS Code · Windsurf · Zed

Seu primeiro prompt

Forneça um arquivo de contrato em PDF ou DOCX e, em seguida, insira:

Extract the key clauses from this NDA and flag any risky provisions.

Seu cliente deve retornar uma lista de cláusulas extraídas e um relatório de riscos classificado por severidade.

Ferramentas

Análise de documentos (4 ferramentas)

  • extract_clauses — identifica e rotula limites de cláusulas com pontuações de confiança; suporta .pdf, .docx, .txt
  • flag_risks — achados de risco classificados por severidade contra um modelo de conformidade
  • check_compliance — validação estruturada de checklist com aprovação/reprovação por regra
  • summarize_terms — resumo em linguagem simples com marcadores das principais disposições

Comparação (1 ferramenta)

  • compare_versions — diff no nível de cláusula entre duas versões de documento

Modelos (1 ferramenta)

  • list_templates — enumera todos os modelos de conformidade disponíveis

Exportação e lote (3 ferramentas)

  • export_analysis_report — relatório HTML autônomo com tabela de cláusulas e achados de risco; adequado para impressão
  • export_audit_log — exporta o log de auditoria da análise em formato JSON ou CSV com filtragem opcional por intervalo de datas
  • bulk_analyze — processa um portfólio de arquivos de contrato em lote com notificações de progresso

Modelos incluídos

Nove modelos de conformidade são incluídos por padrão:

  1. NDA
  2. Contrato de Trabalho
  3. Contrato de Cliente SaaS
  4. Contrato de Licença de Software
  5. Contrato de Fornecedor
  6. Contrato de Consultoria
  7. Contrato de Processamento de Dados
  8. Cessão de Propriedade Intelectual
  9. Contrato de Empréstimo

Use list_templates para enumerar todos os modelos disponíveis em tempo de execução, incluindo quaisquer modelos personalizados carregados via --templates.

Configuração

--templates / --templates-dir

Diretório para carregar modelos de regras de conformidade YAML personalizados. Os modelos neste diretório são mesclados com o conjunto integrado.

Tipo: string

--db / --db-path

Caminho para o arquivo de banco de dados SQLite usado para armazenar o histórico de análise de documentos.

Tipo: string Padrão: ~/.mcp/legal.db

--confidence-threshold

Pontuação mínima de confiança (0–1) para cláusulas extraídas serem incluídas nos resultados. Extrações abaixo deste limite são sinalizadas como de baixa confiança.

Tipo: number Padrão: 0.6

--no-history

Desativa o armazenamento dos resultados da análise de documentos no banco de dados local.

Tipo: boolean Padrão: false

--clause-patterns

Caminho para um arquivo YAML que define padrões personalizados de detecção de cláusulas. Consulte custom-clause-patterns.example.yaml na árvore de fontes para o esquema.

Tipo: string

--bulk-concurrency

Número de arquivos a processar em paralelo ao usar bulk_analyze.

Tipo: number Padrão: 4

--ocr

Ativa o fallback de OCR para PDFs digitalizados que não contêm camada de texto extraível. Requer as dependências opcionais de pares tesseract.js, pdfjs-dist e canvas.

Tipo: boolean Padrão: false

--http-port

Inicia o servidor no modo HTTP Streamable na porta fornecida em vez de stdio. Quando definido, o servidor aceita conexões HTTP adequadas para implantações compartilhadas em equipe.

Tipo: number

Passe flags via a propriedade args na sua configuração JSON:

{
  "mcpServers": {
    "legal-analyzer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-legal-doc-analyzer@latest",
        "--confidence-threshold=0.8",
        "--templates=~/legal/templates"
      ]
    }
  }
}

Verificação

Antes de publicar uma nova versão, verifique o servidor com o MCP Inspector para confirmar que todas as ferramentas estão expostas corretamente e que o handshake do protocolo é bem-sucedido.

Execute npm run build primeiro para que os modelos empacotados em dist/templates estejam presentes durante a verificação.

Interface interativa (abre o navegador):

npm run build && npm run inspect

Modo CLI (scriptado / adequado para CI):

# List all tools
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

# List resources and prompts
npx @modelcontextprotocol/inspector --cli node dist/index.js --method resources/list
npx @modelcontextprotocol/inspector --cli node dist/index.js --method prompts/list

# Call a tool (example — replace with a relevant read-only tool for this plugin)
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name list_templates

# Call a tool with arguments
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name list_templates --tool-arg key=value

Execute antes de publicar para detectar regressões no registro de ferramentas e na inicialização em tempo de execução.

Contribuição

Os modelos de regras de conformidade ficam em src/templates/ como arquivos YAML e podem ser contribuídos sem tocar no código. Os testes de extração de cláusulas devem usar apenas documentos sintéticos ou anonimizados — nunca inclua contratos reais no repositório. Nunca registre conteúdo de documentos.

npm install && npm test

Registro MCP e Marketplace

Este plugin está disponível em:

Pesquise por mcp-legal-doc-analyzer.