Skip to main content
Glama

Starfleet Command — LCARS Bridge Interface

Node.js MCP SDK Express Docker License

Un servidor del Protocolo de Contexto de Modelo (MCP) listo para producción, envuelto en una interfaz de comando LCARS de Star Trek.
Fecha estelar: activa. Todos los sistemas nominales.


◈ INFORME DE LA MISIÓN

"La computadora es la herramienta más democrática jamás inventada. Su propósito es hacer lo que su usuario solicite."
— Directiva del Comando de la Flota Estelar

MCPStarfleetCommand es un servidor mejorado del Protocolo de Contexto de Modelo (MCP) con un panel de control web de estilo LCARS totalmente interactivo, la misma estética hecha famosa por la nave estelar Enterprise. Conecta la integración de Claude Code AI (a través de MCP stdio) con una hermosa consola de comandos basada en navegador, brindándote herramientas de desarrollo, operaciones del sistema de archivos, monitorización del sistema y observabilidad a escala de Docker desde una única interfaz unificada.


Related MCP server: Gitea MCP Proxy Agent

◈ VISTA GENERAL TÁCTICA

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

◈ SISTEMAS DE LA NAVE — CARACTERÍSTICAS

🖖 Interfaz de comando

Capacidad

Estado

Protocolo MCP stdio

✅ Activo

API REST HTTP

✅ Activo

Panel de control web LCARS

✅ En línea

Terminal interactiva

✅ En vivo

Diseño responsivo

✅ Todas las pantallas

🛠️ Operaciones de desarrollo

Herramienta

Descripción

git_status

Estado del repositorio

git_log

Historial completo de commits

git_diff

Diferencias a nivel de archivo

git_branch

Listado de ramas

search_files

Búsqueda recursiva de código

💻 Operaciones del sistema

Herramienta

Descripción

list_files

Navegación de directorios

read_file

Visor de contenido de archivos

write_file

Escritor de archivos

create_directory

Creación de directorios

run_command

Ejecución de shell

system_info

Métricas del sistema en vivo

📊 Procesamiento de datos

Herramienta

Descripción

parse_json

Validación de JSON

format_json

Formateo de JSON


◈ DESPLIEGUE A VELOCIDAD DE CURVATURA

🚀 Opción A — Lanzamiento local (Node.js)

# 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

🐳 Opción B — Flota Docker (Todos los servicios)

# 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

📖 Guía de despliegue completa → DOCKER-README.md · Inicio rápido → QUICKSTART.md


◈ ARQUITECTURA DE LA NAVE

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

Servicio

Puerto

Propósito

Servidor MCP

:3001

Servidor central · Panel LCARS · API REST

Grafana

:3000

Analítica visual · alertas · paneles

Analítica

:3002

Seguimiento de eventos en tiempo real

Prometheus

:9090

Base de datos de métricas de series temporales

cAdvisor

:8080

Monitorización de recursos de contenedores

Redis

:6379

Capa de caché

NGINX

:80/:443

Proxy inverso · SSL


◈ CONSOLA DE COMANDO LCARS — VISTA PREVIA DEL PANEL

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

Starfleet Command — Dashboard Preview

El panel de control cuenta con:

  • ⚡ Terminal interactiva — Ejecución de comandos en tiempo real con salida codificada por colores

  • 📡 Monitorización del sistema — Indicadores en vivo de CPU, memoria, disco y tiempo de actividad

  • 🗂️ Panel de herramientas — Cada herramienta MCP disponible como un botón LCARS de un solo clic

  • 🔐 Operaciones de archivos — Leer, escribir y navegar archivos directamente en el navegador

  • 📊 Integración con Git — Estado, log, diff y ramas de un vistazo


◈ API REST — MATRIZ DE COMUNICACIONES

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

Protocolo MCP — El servidor habla MCP completo a través de stdio. Apunta Claude Code hacia él y se convertirá en una extensión de tu entorno de desarrollo.


◈ COMPUTADORA DE LA NAVE — CONFIGURACIÓN

Variable

Predeterminado

Descripción

PORT

3001

Puerto del servidor HTTP

DEBUG

(sin establecer)

Establece DEBUG=1 para habilitar el registro detallado

NODE_ENV

production

Modo de entorno

Copia .env.example → .env y ajusta antes del lanzamiento.


◈ PROTOCOLOS DE SEGURIDAD

◈  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

◈ MANIFIESTO TECNOLÓGICO — CONSTRUIDO CON

Componente

Tecnología

Entorno de ejecución

Node.js 18+

Protocolo MCP

@modelcontextprotocol/sdk ^1.17

Servidor HTTP

Express.js 5.x

UI del panel

HTML plano · CSS (LCARS) · JS

Analítica

Motor de métricas personalizado

Monitorización

Prometheus + Grafana

Caché

Redis

Proxy

NGINX

Contenedores

Docker + Docker Compose

Linting

ESLint + Prettier


◈ MANIFIESTO DE LA TRIPULACIÓN — DESARROLLO

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

Referencia completa de operaciones → CHEATSHEET.md · Análisis profundo de arquitectura → ARCHITECTURE.md


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

"Para enviar con audacia lo que ningún desarrollador ha enviado antes."

⭐ ¡Dale una estrella a este repositorio si te ayudó a alcanzar la velocidad de curvatura!

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A unified MCP server with composable tools for GitHub operations, file management, shell execution, kanban boards, Discord messaging, and package management. Features role-based security, HTTP/stdio transports, and a web-based development UI.
    -
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A comprehensive MCP server suite that enables AI interaction with Gitea for repository management, secure command execution, and Docker monitoring. It provides additional tools for long-term memory, filesystem access, and web searching to support full development cycles.
    -
  • A
    license
    A
    quality
    D
    maintenance
    A comprehensive MCP server that enables AI models to perform local file operations, command execution, and task management across multiple platforms. It features advanced capabilities like row-level file editing, directory searching, and system monitoring with built-in security filters.
    13
    22 npm
    Mulan Permissive Software , Version 2
  • F
    license
    Not graded
    quality
    F
    maintenance
    MCP server for infrastructure discovery and remote management, enabling SSH command execution, file transfer, log tailing, and machine/service inventory with a companion web dashboard.
    2
    -