┌─────────────────────────────────────────────────────────────────────────────┐
│ ◈ DUAL-INTERFACE DESIGN │
│ │
│ [ Claude Code / AI ] [ Browser ] │
│ │ stdio MCP │ HTTP :3001 │
│ ▼ ▼ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ ENHANCED MCP SERVER CORE │ │
│ │ ┌──────────────┐ ┌──────────────────────┐ │ │
│ │ │ MCP Engine │ │ Express HTTP API │ │ │
│ │ │ (13 Tools) │◄──►│ REST Endpoints │ │ │
│ │ └──────────────┘ └──────────────────────┘ │ │
│ └─────────────────────────────────────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ [ AI responds with ] [ LCARS Dashboard UI ] │
│ tool results Interactive terminal │
│ System monitoring │
│ One-click tool execution │
└─────────────────────────────────────────────────────────────────────────────┘

# 1. Install crew
npm install

# 2. Engage engines
npm start # Production warp
npm run dev # Debug mode (verbose logs)

# 3. Open LCARS console
open http://localhost:3001

# Launch the full starship
docker-compose up -d

# Services come online:
# http://localhost:3001 ← MCP Server + LCARS Dashboard
# http://localhost:3000 ← Grafana Analytics (change default creds in .env!)
# http://localhost:3002 ← Real-time Analytics Engine
# http://localhost:9090 ← Prometheus Metrics
# http://localhost:8080 ← cAdvisor Container Monitor

# Hail all stations
docker-compose logs -f

# Stand down
docker-compose down

 ┌──────────────────────────┐
 │ Internet / NGINX Proxy │
 │ Load Balancing · SSL · Rate Limiting │
 └────────────┬─────────────┘
 │
 ┌──────────────────────┼──────────────────────┐
 │ │ │
 ┌─────────▼──────────┐ ┌────────▼────────┐ ┌─────────▼──────────┐
 │ MCP SERVER │ │ GRAFANA │ │ ANALYTICS │
 │ Port 3001 │ │ Port 3000 │ │ Port 3002 │
 │ HTTP + MCP/stdio │ │ Dashboards │ │ Metrics / Events │
 └─────────┬──────────┘ └────────┬────────┘ └─────────┬──────────┘
 │ │ │
 ┌─────────▼──────────────────────▼──────────────────────▼──────────┐
 │ DATA LAYER │
 │ Redis (cache) · Prometheus (metrics) · Volumes │
 └──────────────────────────────────────────────────────────────────┘

╔══════════════════════════════════════════════════════════════════╗
║ ████ STARFLEET MCP ████████████████████████████████ 47.2 GHz ████║
╠════════════╦═══════════════════════════════════════════════════╣
║ NAV ║ ┌──────────────────────────────────────────┐ ║
║ ▶ TERMINAL ║ │ > system_info │ ║
║ FILES ║ │ ✔ CPU: 12% MEM: 4.2GB UPTIME: 99.9% │ ║
║ GIT ║ │ > git_status │ ║
║ SYSTEM ║ │ ✔ Branch: main Modified: 2 Clean │ ║
║ TOOLS ║ └──────────────────────────────────────────┘ ║
║ ║ ║
║ ▓▓▓▓▓▓▓▓▓▓ ║ [⚡ GIT STATUS] [📁 LIST FILES] [💻 SYS INFO] ║
╚════════════╩═══════════════════════════════════════════════════╝

# ─── Status check ───────────────────────────────────────────────
curl http://localhost:3001/api/status

# ── List all 13 available tools ─────────────────────────────────
curl http://localhost:3001/api/tools

# ── Execute any tool ────────────────────────────────────────────
curl -X POST http://localhost:3001/api/tools/execute \
 -H "Content-Type: application/json" \
 -d '{"tool": "system_info", "args": {}}'

curl -X POST http://localhost:3001/api/tools/execute \
 -H "Content-Type: application/json" \
 -d '{"tool": "git_status", "args": {"repoPath": "."}}'

curl -X POST http://localhost:3001/api/tools/execute \
 -H "Content-Type: application/json" \
 -d '{"tool": "search_files", "args": {"query": "TODO", "searchDir": "."}}'

◈ Input validation on all tool parameters
◈ Path normalization — prevents directory traversal attacks
◈ Command execution sandboxed with 10 MB output buffer
◈ Error messages sanitized before client delivery
◈ NGINX rate limiting in production Docker stack
◈ Non-root container execution in Dockerfile

npm run dev # Engage debug warp (DEBUG=1)
npm run lint # ESLint sweep
npm run lint:fix # Auto-fix lint violations
npm run format # Prettier formatting
npm run format:check # Verify formatting
npm run audit:fix # Fix known vulnerabilities

╔═══════════════════════════════════════════════════════════╗
║ ◈ STARFLEET MCP · ALL SYSTEMS NOMINAL · WARP READY ◈ ║
╚═══════════════════════════════════════════════════════════╝

Looking for Admin?