A production-ready Model Context Protocol platform with a cinematic operations interface.
Mission Time: active. All systems nominal.

◈ MISSION BRIEFING

"The computer is the most democratic tool ever invented. Its purpose is to do whatever its user requests."
— Platform Directive

MCP Command Center is an enhanced Model Context Protocol (MCP) server with a fully interactive operations web dashboard. It bridges Claude Code AI integration (via MCP stdio) with a polished browser-based command console, giving you developer tools, file-system ops, system monitoring, and Docker-scale observability from a single unified interface.

◈ TACTICAL OVERVIEW

┌─────────────────────────────────────────────────────────────────────────────┐
│  ◈ 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 ]           [ Operations Dashboard UI ]                    │
│     tool results                   Interactive terminal                    │
│                                    System monitoring                       │
│                                    One-click tool execution                │
└─────────────────────────────────────────────────────────────────────────────┘

◈ SHIP'S SYSTEMS — FEATURES

🖖 Command Interface

| Capability | Status | |---|---| | MCP stdio protocol | ✅ Active | | HTTP REST API | ✅ Active | | Operations Web Dashboard | ✅ Online | | Interactive terminal | ✅ Live | | Responsive design | ✅ All screens |

🛠️ Developer Operations

| Tool | Description | |---|---| | git_status | Repository status | | git_log | Full commit history | | git_diff | File-level diffs | | git_branch | Branch listing | | search_files | Recursive code search |

💻 System Operations

| Tool | Description | |---|---| | list_files | Directory browsing | | read_file | File content viewer | | write_file | File writer | | create_directory | Directory creation | | run_command | Shell execution | | system_info | Live system metrics |

📊 Data Processing

| Tool | Description | |---|---| | parse_json | JSON validation | | format_json | Pretty-print JSON |

◈ WARP SPEED DEPLOYMENT

🚀 Option A — Local Launch (Node.js)

# 1. Install crew
npm install

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

# 3. Open MCP Command Center
open http://localhost:3001

🐳 Option B — Docker Fleet (All Services)

# Launch the full starship
docker-compose up -d

# Services come online:
#   http://localhost:3001  ← MCP Server + Operations 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

📖 Full deployment guide → DOCKER-README.md · Quick start → QUICKSTART.md

◈ STARSHIP ARCHITECTURE

                      ┌──────────────────────────┐
                      │   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       │
  └──────────────────────────────────────────────────────────────────┘

| Service | Port | Purpose | |---|---|---| | MCP Server | :3001 | Core server · command center dashboard · REST API | | Grafana | :3000 | Visual analytics · alerts · dashboards | | Analytics | :3002 | Real-time event tracking | | Prometheus | :9090 | Time-series metrics database | | cAdvisor | :8080 | Container resource monitoring | | Redis | :6379 | Cache layer | | NGINX | :80/:443 | Reverse proxy · SSL |

◈ OPERATIONS CONSOLE — DASHBOARD PREVIEW

╔══════════════════════════════════════════════════════════════════╗
║ ████ MCP COMMAND CENTER ███████████████████████ 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]   ║
╚════════════╩═══════════════════════════════════════════════════╝

The dashboard features:

• ⚡ Interactive Terminal — Real-time command execution with color-coded output
• 📡 System Monitoring — Live CPU, memory, disk, and uptime gauges
• 🗂️ Tool Panel — Every MCP tool available as a one-click command center control
• 🔐 File Operations — Read, write, browse files directly in browser
• 📊 Git Integration — Status, log, diff, branches at a glance

◈ REST API — COMMUNICATIONS ARRAY

# ─── 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": "."}}'

MCP Protocol — The server speaks full MCP over stdio. Point Claude Code at it and it becomes an extension of your dev environment.

◈ SHIP'S COMPUTER — CONFIGURATION

| Variable | Default | Description | |---|---|---| | PORT | 3001 | HTTP server port | | DEBUG | (unset) | Set DEBUG=1 to enable verbose logging | | NODE_ENV | production | Environment mode |

Copy .env.example → .env and adjust before launch.

◈ SECURITY PROTOCOLS

◈  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

◈ TECH MANIFEST — BUILT WITH

| Component | Technology | |---|---| | Runtime | Node.js 18+ | | MCP Protocol | @modelcontextprotocol/sdk ^1.17 | | HTTP Server | Express.js 5.x | | Dashboard UI | Vanilla HTML · CSS (Command Center theme) · JS | | Analytics | Custom metrics engine | | Monitoring | Prometheus + Grafana | | Cache | Redis | | Proxy | NGINX | | Containers | Docker + Docker Compose | | Linting | ESLint + Prettier |

◈ CREW MANIFEST — DEVELOPMENT

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

Full ops reference → CHEATSHEET.md · Architecture deep-dive → ARCHITECTURE.md

╔═══════════════════════════════════════════════════════════╗
║  ◈  MCP COMMAND CENTER · ALL SYSTEMS NOMINAL · READY  ◈  ║
╚═══════════════════════════════════════════════════════════╝

"To boldly ship what no dev has shipped before."

⭐ Star this repo if it helped you reach warp speed!