castovdev/castov

The Open-Source AI Execution Layer & Privacy-First Developer Suite
Deterministic local tooling for Claude Desktop , Cursor , Windsurf , and Local LLMs via the Model Context Protocol (MCP) — backed by a high-performance CLI, Docker image, IDE extension, and 61 client-first browser utilities.
## ⚡ What is Castov?
Modern AI agents and developer workflows suffer from two critical flaws:
1. Agent Hallucinations on Exact Operations: LLMs frequently blunder arithmetic for CIDR network masks, time zone offsets, epoch milliseconds, and cryptographic key derivations.
2. Data & Secret Leakage: Sending system logs, environment variables, or tokens to third-party cloud APIs presents unacceptable security hazards.
Castov solves both. It acts as an in-situ Execution Layer for developer environments. It provides deterministic, offline, and instant utilities delivered directly to your terminal, editor, Docker containers, and AI agents through the Model Context Protocol (MCP).
Everything runs 100% locally. No external analytics, no telemetry, and zero cloud roundtrips.
### 📊 Castov vs Existing Solutions
| Feature / Capability | ⚡ Castov | 🕵️ CyberChef | 🛠️ DevToys | 🚀 Raycast | 📦 IT-Tools |
| 100% Client-Side Web Crypto | ✅ Yes | ✅ Yes | ❌ Native Only | ❌ Mac Only | ✅ Yes |
| Model Context Protocol (MCP) | ✅ Grade A Server | ❌ No | ❌ No | ❌ Proprietary | ❌ No |
| Terminal CLI (npx castov) | ✅ Built-in | ❌ No | ❌ Separate | ❌ Mac GUI | ❌ No |
| Zero Server Payload Logging | ✅ Air-Gap Safe | ✅ Yes | ✅ Yes | ⚠️ Telemetry | ✅ Yes |
| Cross-Platform (Web/OS/Docker)| ✅ Universal | ⚠️ Web Only | ⚠️ Desktop Only | ❌ macOS Only | ⚠️ Web Only |
| AI Editor Integration (Cursor/Claude) | ✅ Native | ❌ No | ❌ No | ❌ No | ❌ No |
| Process / Port Killer (EADDRINUSE) | ✅ Built-in | ❌ No | ❌ No | ⚠️ Extension | ❌ No |
| Secret & API Key Leak Scanner | ✅ Built-in | ❌ No | ❌ No | ❌ No | ❌ No |
| Open Source (MIT) | ✅ Yes | ✅ Apache 2.0 | ✅ MIT | ❌ Proprietary | ✅ GPL-3.0 |
## 🤖 AI Agent Setup (Model Context Protocol - MCP)
Castov ships with a built-in, production-grade JSON-RPC 2.0 stdio MCP server supporting both Content-Length framed and ndjson stream protocols.
### 1. Claude Desktop
Add Castov to your claudedesktopconfig.json:
macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json
Linux: ~/.config/Claude/claudedesktopconfig.json
json
"mcpServers": {
"castov": {
"command": "npx",
"args": ["-y", "castov", "mcp"]
### 2. Cursor IDE & Windsurf
Go to Settings → Features → MCP Servers → Add New MCP Server:
Name: castov
Type: command
Command: npx -y castov mcp
Alternatively, add to your project's .cursor/mcp.json:
json
"mcpServers": {
"castov": {
"command": "npx",
"args": ["-y", "castov", "mcp"]
### Native Tools Exposed to Agents (10 Tools — All 100% Local & Read-Only)
| MCP Tool | Capability | Example Agent Prompt |
| castovport | Identifies listening services, protocol mappings, and inspects process collision | "Why is port 3000 busy and what service uses it?" |
| castovcidr | Calculates IPv4 subnet masks, wildcard, broadcast, and usable host count | "Calculate usable IP range and subnet mask for 10.240.0.0/22" |