Skip to main content
Glama
README.md
<div align="center">


[![Node.js](https://img.shields.io/badge/Node.js-18%2B-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](https://nodejs.org/)
[![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.17%2B-5555ff?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyTDIgN2wxMCA1IDEwLTV6TTIgMTdsOCA0IDgtNFY3bC04IDR6Ii8+PC9zdmc+)](https://github.com/modelcontextprotocol/sdk)
[![Express](https://img.shields.io/badge/Express-5.x-000000?style=for-the-badge&logo=express&logoColor=white)](https://expressjs.com/)
[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge&logo=docker&logoColor=white)](./DOCKER-README.md)
[![License](https://img.shields.io/badge/License-ISC-ff9900?style=for-the-badge)](./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]   โ•‘
โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฉโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
```

![MCP Command Center โ€” Dashboard Preview](https://github.com/user-attachments/assets/4893c18a-5557-4a6c-8d1f-7e52ee97ec11)

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>