Self-Documenting Zero-Knowledge MCP Server

Un servidor Model Context Protocol (MCP) que escanea de forma autónoma una base de datos legada sin documentar, genera herramientas CRUD para cada tabla, crea prompts que explican cómo combinar tablas y aplica seguridad Zero-Knowledge al restringir el LLM a plantillas SQL previamente validadas.

Arquitectura

Related MCP server: sqlite-mcp

Por qué MCP — y cuál es la ingeniería real

MCP (Model Context Protocol) es la capa de transporte e interfaz aquí: gestiona cómo el LLM llama a las herramientas, pasa parámetros y recibe resultados. Es una elección deliberada, no el logro.

La ingeniería real de este proyecto es el pipeline de introspección de esquema y seguridad que se encuentra debajo:

Database → PRAGMA Introspection → Schema Registry → Template Engine → Security Validator → MCP Tools

Cada etapa no sabe nada de la siguiente. El introspector no sabe nada de MCP. El motor de plantillas no sabe nada de seguridad. El generador de CRUD no sabe nada de SQL — solo trabaja con IDs de plantillas. Esta separación estricta significa que podrías cambiar el transporte MCP por una API REST o un servicio gRPC sin tocar una sola línea de la capa de seguridad.

MCP se eligió en lugar de la llamada directa a funciones de OpenAI porque MCP es agnóstico al transporte (stdio para uso local, SSE para red), admite recursos y prompts más allá de las llamadas de herramientas puras, y es el estándar abierto que se está adoptando en todo el ecosistema de herramientas LLM. Pero la capa de seguridad — plantillas pre-validados, sanitización de defensa en profundidad, registro de plantillas inmutables — funciona de manera idéntica sin importar qué protocolo esté al frente.

Features: Translate descriptions

• "Autonomous Schema Discovery" → "Descubrimiento Autónomo de Esquema"

• "Dynamic CRUD Tools" → "Herramientas CRUD Dinámicas"

• "Join Prompts" → "Prompts de Unión (Join)"

• "Zero-Knowledge Security" → "Seguridad de Conocimiento Cero"

• "Audit Logging" → "Registro de Auditoría"

• "Schema Resources" → "Recursos de Esquema"

Quick Start → Inicio Rápido

• Prerequisites → Requisitos previos

• Installation → Instalación

• Seed the Demo Database → Sembrar la base de datos de demostración

• Run the Server → Ejecutar el servidor

• Connect with Claude Desktop → Conectar con Claude Desktop

• Test with MCP Inspector → Probar con MCP Inspector

The description paragraphs need translation.

What Gets Generated: translate the intro and table descriptions.

Prompts table: descriptions need translation.

Tools table: descriptions need translation.

Resources table: descriptions need translation.

Running Tests: GXP7 stays

Project Structure: GXP8 stays

License: MIT stays

Let me write the full translation now, preserving all structure exactly.# Self-Documenting Zero-Knowledge MCP Server

Un servidor Model Context Protocol (MCP) que escanea de forma autónoma una base de datos legada sin documentar, genera herramientas CRUD para cada tabla, crea prompts que explican cómo unir tablas y aplica seguridad Zero-Knowledge al restringir el LLM únicamente a plantillas SQL pre-validados.

Arquitectura

Por qué MCP — y cuál es la ingeniería real

MCP (Model Context Protocol) es la capa de transporte e interfaz aquí — gestiona cómo el LLM llama a las herramientas, pasa parámetros y recibe resultados. Es una elección deliberada, no el logro.

La ingeniería real en este proyecto es el pipeline de introspección de esquema y seguridad que se encuentra debajo:

Database → PRAGMA Introspection → Schema Registry → Template Engine → Security Validator → MCP Tools

Cada etapa no sabe nada de la siguiente. El introspector no sabe nada de MCP. El motor de plantillas no sabe nada de seguridad. El generador de CRUD no sabe nada de SQL — solo trabaja con IDs de plantillas. Esta separación estricta significa que podrías sustituir el transporte MCP por una API REST o un servicio gRPC sin tocar una sola línea de la capa de seguridad.

MCP se eligió en lugar de la llamada directa a funciones de OpenAI porque MCP es agnóstico al transporte (stdio para uso local, SSE para red), admite recursos y prompts más allá de las llamadas de herramientas puras, y es el estándar abierto que se está adoptando en todo el ecosistema de herramientas LLM. Pero la capa de seguridad — plantillas pre-validados, sanitización de defensa en profundidad, registro de plantillas inmutable — funciona independientemente del protocolo que se sitúe delante.

Características

• Descubrimiento Autónomo de Esquema — Escanea cualquier base de datos SQLite mediante introspección PRAGMA sin conocimiento previo

• Herramientas CRUD Dinámicas — Genera automáticamente herramientas de Crear, Leer, Actualizar, Eliminar, Listar y Buscar para cada tabla descubierta

• Prompts de Joins — Analiza las relaciones de claves foráneas y genera prompts que explican cómo combinar tablas

• Seguridad de Conocimiento Cero — Toda la ejecución de SQL se restringe a plantillas parametrizadas previamente validadas

• Registro de Auditoría — Cada operación de base de datos se registra con timestamp, ID de plantilla y parámetros

• Recursos de Esquema — Los recursos de MCP exponen el esquema descubierto para referencia del LLM

Inicio Rápido

Requisitos Previos

• Python 3.10+

• pip

Instalación

# Clone the repository
git clone https://github.com/shubhtiwari65/Self-Documenting-Zero-Knowledge-MCP-Server.git
cd "MCP SERVER"

# Install dependencies
pip install -r requirements.txt

# Or install in editable mode with dev tools (recommended)
pip install -e ".[dev]"

Sembrar la Base de Datos Demo

# Create a sample e-commerce legacy database
python server.py --seed

Esto crea legacy_store.db con 6 tablas: categories, customers, orders, order_items, products, reviews — con relaciones de clave foránea y datos de ejemplo.

Ejecutar el Servidor

# Run with stdio transport (default — for Claude Desktop)
python server.py

# Run with SSE transport (for network access)
python server.py --transport sse --port 8080

# Use a custom database
python server.py --db /path/to/your/database.db

Conectar con Claude Desktop

Añade a la configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "zk-database": {
      "command": "python",
      "args": ["C:/path/to/MCP SERVER/server.py", "--db", "C:/path/to/legacy_store.db"]
    }
  }
}

Probar con el Inspector de MCP

mcp dev server.py

Qué se Genera

Cuando el servidor se inicia, inspecciona la base de datos y auto-genera:

Herramientas (por tabla)

Prompts

Recursos

Seguridad Zero-Knowledge

El proyecto implementa un modelo de seguridad de conocimiento cero en tres capas:

1. Introspector — Descubre el esquema mediante PRAGMA de SQLite, sin conocimiento previo de la base de datos

2. Motor de Plantillas — Genera plantillas SQL parametrizadas a partir del esquema descubierto

3. Registro de Plantillas — Almacena plantillas en un registro inmutable; el LLM solo puede elegir IDs de plantilla

Cómo Funciona

Database → PRAGMA Introspection → Schema Registry → Template Engine → Security Validator → MCP Tools

La clave de la seguridad es que el LLM nunca construye SQL directamente. Solo selecciona un ID de plantilla y proporciona parámetros. El servidor valida los parámetros contra el esquema y ejecuta la plantilla pre-construida.

Ejecutar Pruebas

# Run all tests
python -m pytest

# Run with coverage report
python -m pytest --cov=src --cov-report=term-missing

# Run specific test files
python -m pytest tests/test_security.py -v
python -m pytest tests/test_introspector.py -v

Licencia

MIT