Castov

Castov

La Capa de Ejecución de IA de Código Abierto y Suite de Desarrollo con Cero Telemetría

Herramientas locales deterministas para Claude Desktop, Cursor, Windsurf y LLMs Locales mediante el Protocolo de Contexto de Modelo (MCP), respaldadas por una CLI de alto rendimiento, imagen Docker, extensión de IDE y más de 63 utilidades de navegador sin conexión.

---

⚡ ¿Qué es Castov?

Los agentes de IA modernos y los flujos de trabajo de desarrollo sufren dos fallos críticos:

1. Alucinaciones de agentes en operaciones exactas: Los LLM frecuentemente cometen errores en aritmética de máscaras de red CIDR, desplazamientos de zona horaria, milisegundos de época y derivaciones de claves criptográficas.
2. Fuga de datos y secretos: Enviar registros del sistema, variables de entorno o tokens a APIs en la nube de terceros presenta riesgos de seguridad inaceptables.

Castov resuelve ambos. Actúa como una Capa de Ejecución in-situ para entornos de desarrollo. Proporciona utilidades deterministas, sin conexión e instantáneas entregadas directamente a tu terminal, editor, contenedores Docker y agentes de IA a través del Protocolo de Contexto de Modelo (MCP).

Todo se ejecuta 100% localmente. Sin análisis externos, sin telemetría y cero viajes de ida y vuelta a la nube.

---

🤖 Configuración de Agentes de IA (Protocolo de Contexto de Modelo - MCP)

Castov incluye un servidor MCP stdio JSON-RPC 2.0 de grado de producción integrado que soporta tanto protocolos de flujo Content-Length enmarcados como ndjson.

1. Claude Desktop

Añade Castov a tu claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "castov": {
      "command": "npx",
      "args": ["-y", "castov", "mcp"]
    }
  }
}

2. IDE Cursor y Windsurf

Ve a Configuración → Funciones → Servidores MCP → Añadir Nuevo Servidor MCP:

• Nombre: castov
• Tipo: command
• Comando: npx -y castov mcp

Alternativamente, añade a tu proyecto .cursor/mcp.json:

{
  "mcpServers": {
    "castov": {
      "command": "npx",
      "args": ["-y", "castov", "mcp"]
    }
  }
}

Herramientas Nativas Expuestas a Agentes (10 Herramientas — Todas 100% Locales y Solo Lectura)

Herramienta MCP	Capacidad	Ejemplo de Prompt de Agente
castov_port	Identifica servicios en escucha, mapeos de protocolo e inspecciona colisiones de procesos	"¿Por qué el puerto 3000 está ocupado y qué servicio lo usa?"
castov_cidr	Calcula máscaras de subred IPv4, comodín, difusión y recuento de hosts utilizables	"Calcula el rango IP utilizable y la máscara de subred para 10.240.0.0/22"
castov_detect_id	Decodifica marcas de tiempo de creación integradas de UUIDv7, ULID, ObjectId, Snowflake	"¿Cuándo se creó este ObjectId de MongoDB o ID de Snowflake?"
castov_timestamp	Conversión bidireccional de época a ISO 8601, UTC y representaciones localizadas	"Convierte 1713456789 a formato UTC humano e ISO"
castov_cron	Analiza horarios cron de 5 campos a inglés sencillo y calcula las próximas 5 ejecuciones	"Explica cron 0 9 * * 1-5 y muestra las próximas 5 ejecuciones en America/New_York"
castov_timezone	Convierte marcas de tiempo entre zonas horarias IANA con advertencias de transición DST	"Convierte 2026-03-29 14:30 de America/New_York a Europe/Paris"
castov_secret	Genera CSPRNG Hex de 256 bits, Base64URL, claves API y secretos UUIDv7 ordenables	"Genera un secreto criptográfico de 256 bits para AUTH_SECRET y JWT_SECRET"
castov_jwt_decode	Decodifica encabezados JWT, cargas útiles y estado exp sin conexión con cero llamadas de red	"Decodifica este JWT sin conexión y verifica si ha expirado"
castov_hash	Calcula resúmenes SHA-256/384/512, SHA-1, MD5 y codificaciones Base64/Base64URL	"Calcula el resumen hex SHA-256 y la codificación Base64URL de esta carga útil de webhook"
castov_scan_secrets	Audita fragmentos de código, diffs de git o bloques .env para detectar claves API y claves privadas filtradas	"Escanea este diff de git para detectar claves AWS, Stripe u OpenAI codificadas accidentalmente"

---

📦 Distribución Multicanal

Castov está disponible en todos los lugares donde ocurre la ingeniería moderna:

1. CLI de Terminal (Node.js / npm)

Ejecuta al instante sin instalación:

npx castov --help

O instala globalmente:

npm install -g castov
castov --help

2. Contenedor Docker (Docker Hub)

Contenedor ligero Alpine Linux (node:20-alpine) que se ejecuta bajo un usuario no root node:

# Run one-off command
docker run --rm castovdev/castov:latest uuid --v7

# Interactive diagnostic shell
docker run -it --rm castovdev/castov:latest

3. Tap de Homebrew (macOS y Linux)

Instala nativamente vía Brew:

brew tap castovdev/castov
brew install castov

# Verify installation
castov --version

4. Extensiones para VS Code, Cursor y Windsurf

Instala la extensión oficial directamente dentro de tu editor:

• Mercado de VS Code: Busca Castov o instala Castov.castov-vscode
• Registro Open VSX: Disponible para Cursor, Windsurf, VSCodium: castov/castov-vscode

# Command line installation
code --install-extension Castov.castov-vscode

5. Acción de GitHub (Pipelines CI/CD)

Automatiza escaneos de seguridad, auditorías de fuga de secretos y verificaciones de entorno en tus flujos de trabajo de GitHub:

- name: Run Castov Secret Scanner
  uses: castovdev/castov-action@v1.0.0
  with:
    command: 'scan .'

---

🛠️ Inicio Rápido de CLI y Comandos Principales

castov <command> [options]

🔍 Gestor de Procesos y Puertos (Asesino de EADDRINUSE)

Inspecciona qué proceso ocupa un puerto o elimínalo limpiamente:

# Inspect service and protocol
castov port 3000

# Inspect active process PID and terminate it immediately
castov port 3000 --kill

🔐 Generador de Secretos Criptográficos

Genera claves de alta entropía para .env, NEXTAUTH_SECRET, firma JWT y autenticación API:

castov secret
castov secret --len 64

🌐 Calculadora de Subred y CIDR

Calcula máscaras de red, máscaras comodín y rangos de hosts utilizables con cero consultas externas:

castov cidr 192.168.1.0/24
castov cidr 10.0.0.0/16

🛡️ Escáner Local de Fuga de Secretos

Escanea recursivamente directorios locales en busca de tokens API confirmados o no confirmados (AWS, Stripe, OpenAI, GitHub, Claves Privadas):

castov scan .

🚑 Sanador de Registros de Fallos y Errores de Terminal

Envía fallos de terminal o pega trazas de error para remediación instantánea y determinista:

castov fix "Error: listen EADDRINUSE: address already in use :::8080"
npm run build 2>&1 | castov fix

🧠 Generador de Reglas de IA y Prompts de Sistema

Inicializa .cursorrules o CLAUDE.md con prácticas de ingeniería reforzadas:

castov rules nextjs --write
castov rules fastapi
castov rules rust

⏱️ Detector Universal de ID y Marca de Tiempo

Extrae metadatos y marcas de tiempo de época de cualquier identificador distribuido moderno:

castov detect 018e3a2b-8a5c-7b00-9821-654321abcdef
castov detect 507f1f77bcf86cd799439011
castov ts 1713456789

---

🌐 Suite Completa de 63 Herramientas de Desarrollo

Además de la CLI y el Servidor MCP, Castov proporciona 63 herramientas web del lado del cliente accesibles en castov.com:

Categoría	Herramientas Destacadas
Seguridad y Privacidad	Bóveda de Entorno con Esteganografía, Escáner de Secretos del Lado del Cliente, Bóveda de Entorno de Conocimiento Cero, Generador de Hash (SHA-256/512/MD5), Decodificador JWT, Codificador/Decodificador Base64, Generador UUID v4/v7.
Redes y DevOps	Inspector de Puertos EADDRINUSE, Calculadora CIDR IPv4, Visualizador de Dockerfile, Túnel Fantasma P2P, Generador de Mocks Fetch, Probador de Carga API, Inspector DNS y de Encabezados.
Datos y Arquitectura	Generador de Tipos TypeScript desde JSON, Galaxia JSON 3D, Formateador y Visor JSON Interactivo, Fiddle SQLite en Navegador, Verificador de Diferencias Línea por Línea, Telepatía de Conflictos AST.
Frontend y UI	Estudio CSS Glassmorphism, Generador de Maquetas de Apps, Renderizador de Código a Imagen de Alta Resolución, Generador de Favicon, Constructor de README de Perfil GitHub.
Tiempo y Programación (25+ Herramientas)	Convertidor de Marca de Tiempo Unix, Convertidor de Época, Analizador ISO 8601 y RFC 3339, Convertidor y Simulador de Zonas Horarias, Generador y Explicador de Cron en Inglés Sencillo, Reloj Mundial, Matriz de Horario Comercial, Milisegundos a Fecha.

---

🔒 Garantía de Privacidad y Cero Telemetría

Las herramientas de ingeniería nunca deberían filtrar tu IP, secretos de empresa o fragmentos de código.

• 0 Cookies de Análisis o Seguimiento: Sin PostHog, Google Analytics ni scripts de telemetría de terceros.
• Sin Conexión Primero: Todas las operaciones criptográficas dependen del navegador y la API Web Crypto nativa del tiempo de ejecución SubtleCrypto.
• Compatible con Aislamiento: Tanto la CLI, la imagen Docker como la aplicación web pueden ejecutarse en entornos sin conexión e intranets restringidas.

---

💻 Desarrollo Local

Castov está construido con Next.js 16 (App Router), TypeScript (Estricto) y Tailwind CSS v4.

# 1. Clone repository
git clone https://github.com/castovdev/castov.git
cd castov

# 2. Install dependencies
npm install

# 3. Setup local environment
cp .env.example .env.local

# 4. Start development server
npm run dev

# 5. Build CLI and Web applications
npm run build

Para ejecutar pruebas en todos los paquetes:

npm run test

---

📄 Licencia

Castov es software de código abierto licenciado bajo la Licencia MIT — Copyright © 2026 Abdelmalik Benidir / Castov (castov.com). Gratuito para uso personal, comercial y empresarial.