🛡️ KryptonMCP

La puerta de enlace de seguridad y privacidad Zero-Trust para agentes de IA

Enmascaramiento determinista de PII • Salvaguardas contra inyección de prompts • Credenciales efímeras JIT • Registro de auditoría Merkle firmado criptográficamente

🤖 Integración instantánea del proyecto con IA

¿Integrando en un proyecto existente? Proporcionamos un prompt de IA listo para usar en KRYPTON_INTEGRATION_PROMPT.md.

Simplemente copia y pega el prompt completo en Claude Code, Cursor Composer, Windsurf o Antigravity dentro de tu proyecto, y tu asistente de IA auditará automáticamente tus herramientas, generará krypton.yaml, creará claves de auditoría Ed25519 y conectará todos los clientes MCP de forma transparente.

Related MCP server: Node9-Proxy

⚡ ¿Por qué KryptonMCP?

Conectar modelos de IA (como Claude, Cursor, Windsurf, LangChain, AutoGen) directamente a bases de datos, instancias de Redis y APIs empresariales presenta desafíos de seguridad catastróficos:

1. Fuga de PII y datos: Las tarjetas de crédito de clientes, correos electrónicos, SSNs y claves de API privadas en texto claro se envían directamente a los proveedores de LLM en la nube en los contextos de prompt.

2. Inyección y secuestro de prompts: Usuarios malintencionados o inyecciones indirectas de contenido engañan a los modelos para que ejecuten herramientas destructivas (DROP TABLE, rm -rf, exfiltración).

3. Credenciales estáticas de larga duración: Conceder contraseñas de bases de datos o tokens de administración a los agentes de IA crea puertas traseras persistentes.

4. Falta de cumplimiento verificable: El registro tradicional puede ser alterado o borrado, lo que incumple los estándares de auditoría SOC2, HIPAA e ISO27001.

KryptonMCP es una puerta de enlace de seguridad y privacidad Zero-Trust autónoma y de un solo binario que se sitúa de forma transparente entre tus clientes de IA y las herramientas MCP posteriores, sin requerir agentes externos como HashiCorp Vault.

🌟 Pilares centrales

flowchart TD
    Client["🤖 AI Client (Claude / Cursor / Windsurf / LangChain)"]

    subgraph InboundPipeline["🔒 Inbound Security Pipeline"]
        G["1. Prompt-Injection Guardrails & RBAC"]
        D["2. Inbound Detokenization Engine"]
        B["3. JIT Ephemeral Credential Broker"]
        A1["4. Merkle Audit Signer (Ed25519)"]
        G --> D --> B --> A1
    end

    Downstream[("🗄️ Downstream Services (Postgres, Redis, Remote APIs)")]

    subgraph OutboundPipeline["🎭 Outbound Privacy Pipeline"]
        M["5. In-Flight PII Masker (AES-256-GCM Vault)"]
        A2["6. Merkle Leaf Digest & JSONL Sync"]
        M --> A2
    end

    Client -->|"1. JSON-RPC Tool Request (stdio / SSE)"| G
    A1 -->|"2. Sanitized Cleartext Request"| Downstream
    Downstream -->|"3. Raw Database / API Result"| M
    A2 -->|"4. Protected Result with Surrogate Tokens ([EMAIL_REF_...])"| Client

1. 🎭 Enmascaramiento determinista de PII en tránsito

• Expurgo transparente: Reemplaza datos sensibles (tarjetas de crédito, SSNs, correos electrónicos, claves de API, JWTs, números de teléfono, IPv4/IPv6) con tokens sustitutos reversibles ([EMAIL_REF_a1b2c3d4], [CREDIT_CARD_REF_8f9e0a1b]) antes de que las cargas útiles lleguen al LLM.

• Validación algorítmica: Escaneo de alta precisión con sumas de comprobación Luhn Mod 10, verificaciones de área SSA y cero falsos positivos en código estándar.

• Destokenización reversible: Cuando el LLM llama a una herramienta posterior con un token sustituto, Krypton destokeniza el parámetro de vuelta a texto claro en tránsito.

• Bóveda criptográfica en memoria: Cero almacenamiento en disco en texto claro; todas las asignaciones de sustitutos están protegidas en memoria con claves efímeras AES-256-GCM.

2. 🛡️ Salvaguardas contra inyección de prompts y ejecución de herramientas

• Detección de amenazas multivectorial: Bloquea anulaciones de instrucciones, jailbreaks de modo DAN/desarrollador, inyecciones de delimitadores (<|im_start|>, <<SYS>>) y cargas útiles ofuscadas con Base64.

• RBAC declarativo de herramientas: Listas permitidas con comodines (query_*) y listas denegadas (drop_*, execute_shell).

• Restricciones de parámetros: Validación a nivel de campo (patrones regex, longitud mín/máx, límites numéricos).

• Limitación de velocidad de ventana deslizante: Evita bucles de ejecución recursiva descontrolados.

3. 🔑 Credenciales efímeras Just-In-Time (JIT)

• Microcredenciales dinámicas: Genera usuarios de bases de datos y de caché de corta duración bajo demanda con TTLs inferiores a una hora.

• Revocación automatizada: Temporizadores de fondo de precisión terminan automáticamente las sesiones del backend y eliminan los roles temporales al expirar el arrendamiento.

• Controladores integrados: Controladores nativos para PostgreSQL (CREATE ROLE ... VALID UNTIL, pg_terminate_backend, DROP ROLE) y Redis (ACL SETUSER, CLIENT KILL USER, ACL DELUSER).

• Herramientas MCP nativas: Expone krypton_request_credential, krypton_revoke_credential y krypton_list_leases.

4. 🔏 Registro de auditoría Merkle firmado criptográficamente

• Separación de dominios RFC 6962: Árbol de Merkle binario de solo anexado que registra cada solicitud, respuesta, llamada a herramienta y arrendamiento de credenciales.

• Firmas asimétricas Ed25519: Firma matemáticamente los puntos de control de la raíz de Merkle.

• Detección de manipulación: La alteración o eliminación de registros de log pasados rompe inmediatamente la verificación criptográfica.

• Verificador CLI y exportador de pruebas: krypton audit verify y krypton audit proof para auditores de cumplimiento.

🚀 Inicio rápido (30 segundos)

Instalación

# Option 1: Install with Go (Zero dependencies)
go install github.com/krypton-mcp/krypton/cmd/krypton@v0.1.0-alpha

# Option 2: Pull the production Docker image
docker pull ghcr.io/muhammetemirerkut/krypton-mcp:latest

# Option 3: Build from source
git clone https://github.com/MuhammetEmirErkut/krypton-mcp.git
cd krypton-mcp
go build -o krypton ./cmd/krypton

Inicializar configuración y claves de auditoría

# 1. Generate production configuration template
krypton config init --out krypton.yaml

# 2. Generate Ed25519 cryptographic audit signing keypair
krypton audit keygen --out-dir ./security-keys

⚙️ Integración con clientes

1. Configuración de Claude Desktop (modo proxy Stdio)

Añade Krypton como proxy transparente en ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "postgres-secure": {
      "command": "/usr/local/bin/krypton",
      "args": [
        "start",
        "--config", "/path/to/krypton.yaml",
        "--",
        "npx", "-y", "@modelcontextprotocol/server-postgres", "postgresql://admin:password@localhost:5432/mydb"
      ]
    }
  }
}

2. Integración de Cursor IDE / MCP remoto (modo HTTP y SSE)

Para entornos contenerizados o remotos, lanza Krypton como una puerta de enlace de red segura:

# Launch SSE gateway on port 8080 proxying a remote MCP service
krypton start --transport sse --host 0.0.0.0 --port 8080 --downstream-url http://downstream-service:8001/rpc

Añade a .cursor/mcp.json en tu espacio de trabajo:

{
  "mcpServers": {
    "secure-gateway": {
      "command": "krypton",
      "args": ["start", "--config", "./krypton.yaml"]
    }
  }
}

📋 Especificación de configuración (krypton.yaml)

version: "v1"

server:
  transport: "stdio" # "stdio" or "sse"
  host: "127.0.0.1"
  port: 8080
  log_level: "info"

downstream:
  transport: "stdio" # "stdio" or "http"
  # url: "http://localhost:8001/rpc"
  command: ""
  args: []

security:
  masking_enabled: true
  guardrails_enabled: true
  audit_enabled: true
  ephemeral_creds_enabled: true

masking:
  mode: "tokenize" # "tokenize", "redact", or "hash"
  builtin_rules:
    - "email"
    - "credit_card"
    - "ssn"
    - "api_key"
    - "jwt"
    - "phone"
    - "ip_address"

guardrails:
  block_injection: true
  block_exfiltration: true
  max_prompt_size_bytes: 1048576 # 1 MB
  # Declarative Tool RBAC
  allowed_tools:
    - "*"
  denied_tools:
    - "drop_*"
    - "delete_database"
    - "execute_raw_shell"

audit:
  log_path: "./audit.jsonl"
  sign_enabled: true
  signing_key_path: "./krypton_audit.key"
  public_key_path: "./krypton_audit.pub"

💻 Matriz de comandos CLI

📊 Puntos de referencia de rendimiento

Medido en Apple M2 (arm64, Go 1.26):

🔒 Seguridad y divulgación de vulnerabilidades

KryptonMCP se toma en serio las vulnerabilidades de seguridad. Si descubres una vulnerabilidad, infórmala a través de GitHub Private Vulnerability Reporting o envía un correo electrónico a security@krypton-mcp.org. No abras issues públicos para vulnerabilidades de día cero.

📄 Licencia

Apache License 2.0. Consulta LICENSE para más detalles.