Enhanced MCP Server
by Jacobcdsmith
README.md
<div align="center">
[](https://nodejs.org/)
[](https://github.com/modelcontextprotocol/sdk)
[](https://expressjs.com/)
[](./DOCKER-README.md)
[](./package.json)
**A production-ready Model Context Protocol platform with a cinematic operations interface.**
*Mission Time: active. All systems nominal.*
</div>
---
## โ 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)](https://modelcontextprotocol.io/) 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
<table>
<tr>
<td width="50%" valign="top">
### ๐ 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 |
</td>
<td width="50%" valign="top">
### ๐ป 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 |
</td>
</tr>
</table>
---
## โ WARP SPEED DEPLOYMENT
### ๐ Option A โ Local Launch (Node.js)
```bash
# 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)
```bash
# 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`](./DOCKER-README.md) ยท Quick start โ [`QUICKSTART.md`](./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
```bash
# โโโ 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
```bash
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`](./CHEATSHEET.md) ยท Architecture deep-dive โ [`ARCHITECTURE.md`](./ARCHITECTURE.md)
---
<div align="center">
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ 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!**
</div>
Maintenance
ActivityInactive
ResponsivenessNo recent community issues