MCP Legal Doc Analyzer

Herramientas MCP específicas del dominio para flujos de trabajo de documentos legales: extraer cláusulas, verificar cumplimiento, señalar riesgos

GitHub

Documentación

MCP Legal Document Analyzer

Paquete npm mcp-legal-doc-analyzer

Herramientas MCP específicas de dominio para flujos de trabajo de documentos legales. Extrae cláusulas clave de contratos, señala disposiciones de riesgo frente a plantillas de reglas configurables, compara versiones de documentos a nivel de cláusula y verifica el cumplimiento frente a listas de verificación estándar, todo localmente, sin que los documentos salgan de tu máquina.

Referencia de herramientas | Configuración | Contribuciones | Solución de problemas

Características principales

Extracción de cláusulas: Identifica y etiqueta los límites de las cláusulas (terminación, responsabilidad, propiedad intelectual, ley aplicable y más) a partir de archivos PDF, DOCX y texto plano.
Señalización de riesgos: Verifica las cláusulas extraídas contra plantillas de reglas YAML y devuelve hallazgos ordenados por severidad.
Verificación de cumplimiento: Valida documentos contra listas de verificación estructuradas (NDA, contrato laboral, términos SaaS) con aprobado/fallido por requisito.
Comparación de versiones: Compara dos versiones de un documento a nivel de cláusula, no de líneas de texto sin procesar.
Plantillas configurables: Los conjuntos de reglas son archivos YAML que los profesionales legales pueden revisar y editar sin escribir código.
Procesamiento solo local: Todo el análisis y procesamiento se ejecuta en el dispositivo; los documentos nunca se transmiten externamente.

Avisos legales

mcp-legal-doc-analyzer es una ayuda de análisis, no asesoría legal. Los resultados deben ser revisados por un profesional legal calificado antes de tomar decisiones. La extracción de cláusulas utiliza coincidencia de patrones y heurísticas; los resultados pueden ser incompletos o incorrectos para formatos de documentos no estándar. Las extracciones de baja confianza se señalan explícitamente.

El contenido de los documentos se procesa localmente y se almacena en una base de datos SQLite local. No compartas exportaciones de la base de datos que contengan documentos confidenciales.

Requisitos

Node.js v20.19 o superior.
npm.

Primeros pasos

Agrega la siguiente configuración a tu cliente MCP:

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

Para cargar plantillas de cumplimiento personalizadas desde un directorio:

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

Configuración del cliente MCP

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

Tu primer prompt

Proporciona un archivo de contrato en PDF o DOCX y luego ingresa:

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

Tu cliente debería devolver una lista de cláusulas extraídas y un informe de riesgos ordenado por severidad.

Herramientas

Análisis de documentos (4 herramientas)

extract_clauses — identifica y etiqueta los límites de las cláusulas con puntuaciones de confianza; admite .pdf, .docx, .txt
flag_risks — hallazgos de riesgo ordenados por severidad contra una plantilla de cumplimiento
check_compliance — validación estructurada de aprobado/fallido por regla
summarize_terms — resumen en lenguaje sencillo con viñetas de las disposiciones clave

Comparación (1 herramienta)

compare_versions — diferencia a nivel de cláusula entre dos versiones de un documento

Plantillas (1 herramienta)

list_templates — enumera todas las plantillas de cumplimiento disponibles

Exportación y procesamiento por lotes (3 herramientas)

export_analysis_report — informe HTML autocontenido con tabla de cláusulas y hallazgos de riesgo; adecuado para imprimir
export_audit_log — exporta el registro de auditoría del análisis en formato JSON o CSV con filtrado opcional por rango de fechas
bulk_analyze — procesa un portafolio de archivos de contrato en lote con notificaciones de progreso

Plantillas incluidas

Se incluyen nueve plantillas de cumplimiento de serie:

NDA
Contrato laboral
Acuerdo de cliente SaaS
Acuerdo de licencia de software
Acuerdo de proveedor
Acuerdo de consultoría
Acuerdo de procesamiento de datos
Cesión de propiedad intelectual
Acuerdo de préstamo

Usa list_templates para enumerar todas las plantillas disponibles en tiempo de ejecución, incluidas las plantillas personalizadas cargadas mediante --templates.

Configuración

`--templates` / `--templates-dir`

Directorio para cargar plantillas de reglas de cumplimiento YAML personalizadas. Las plantillas de este directorio se combinan con el conjunto integrado.

Tipo: string

`--db` / `--db-path`

Ruta al archivo de base de datos SQLite utilizado para almacenar el historial de análisis de documentos.

Tipo: string Valor predeterminado: ~/.mcp/legal.db

`--confidence-threshold`

Puntuación mínima de confianza (0–1) para que las cláusulas extraídas se incluyan en los resultados. Las extracciones por debajo de este umbral se señalan como de baja confianza.

Tipo: number Valor predeterminado: 0.6

`--no-history`

Desactiva el almacenamiento de los resultados del análisis de documentos en la base de datos local.

Tipo: boolean Valor predeterminado: false

`--clause-patterns`

Ruta a un archivo YAML que define patrones personalizados de detección de cláusulas. Consulta custom-clause-patterns.example.yaml en el árbol de fuentes para ver el esquema.

Tipo: string

`--bulk-concurrency`

Número de archivos a procesar en paralelo al usar bulk_analyze.

Tipo: number Valor predeterminado: 4

`--ocr`

Habilita el respaldo OCR para PDF escaneados que no contienen capa de texto extraíble. Requiere las dependencias opcionales tesseract.js, pdfjs-dist y canvas.

Tipo: boolean Valor predeterminado: false

`--http-port`

Inicia el servidor en modo HTTP Streamable en el puerto indicado en lugar de stdio. Cuando se establece, el servidor acepta conexiones HTTP adecuadas para implementaciones compartidas en equipo.

Tipo: number

Pasa los indicadores mediante la propiedad args en tu configuración JSON:

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

Verificación

Antes de publicar una nueva versión, verifica el servidor con MCP Inspector para confirmar que todas las herramientas estén expuestas correctamente y que el protocolo de enlace se complete correctamente.

Ejecuta npm run build primero para que las plantillas empaquetadas en dist/templates estén presentes durante la verificación.

Interfaz interactiva (abre el navegador):

npm run build && npm run inspect

Modo CLI (scriptado / apto 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

Ejecuta antes de publicar para detectar regresiones en el registro de herramientas y el inicio del tiempo de ejecución.

Contribuciones

Las plantillas de reglas de cumplimiento se encuentran en src/templates/ como archivos YAML y se pueden contribuir sin tocar código. Las pruebas de extracción de cláusulas deben usar únicamente documentos sintéticos o anonimizados; nunca incluyas contratos reales en el repositorio. Nunca registres el contenido de los documentos.

npm install && npm test

Registro MCP y Marketplace

Este plugin está disponible en:

Busca mcp-legal-doc-analyzer.