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!