stdout-mcp-server

stdout-mcp-server

Un servidor de Protocolo de Contexto de Modelo (MCP) que captura y gestiona registros de stdout a través de un sistema de tuberías con nombre. Este servidor es particularmente útil para:

• Capturar registros de múltiples procesos o aplicaciones y hacerlos disponibles para depuración en Cursor IDE.
• Monitorear la salida de aplicaciones en tiempo real y proporcionar una interfaz MCP para consultar, filtrar y analizar registros.

Cómo Funciona

1. El servidor crea una tubería con nombre en una ubicación específica (/tmp/stdout_pipe en Unix/MacOS o \\.\pipe\stdout_pipe en Windows)

2. Cualquier aplicación puede escribir registros en esta tubería usando la redirección estándar de salida. Por ejemplo:

your_application | tee /tmp/stdout_pipe # or
your_application > /tmp/stdout_pipe

3. El servidor monitorea la tubería, captura todos los registros entrantes y mantiene un historial de las últimas 100 entradas

4. A través de las herramientas MCP, puedes consultar, filtrar y analizar estos registros

Requisitos del Sistema

Antes de instalar, asegúrate de tener:

• Node.js v18 o más reciente

Opciones de Instalación

Opción 1: Instalación en Cursor

1. Abre Cursor y navega a Cursor > Settings > MCP Servers
2. Haz clic en "Agregar nuevo servidor MCP"
3. Actualiza tu archivo de configuración MCP con la siguiente configuración:

name: stdout-mcp-server
type: command
command: npx stdout-mcp-server

Opción 2: Instalación en otros clientes MCP

Instalación en otros clientes MCP

Para macOS/Linux:

{
  "mcpServers": {
    "stdio-mcp-server": {
      "command": "npx",
      "args": [
        "stdio-mcp-server"
      ]
    }
  }
}

Para Windows:

{
  "mcpServers": {
    "mcp-installer": {
      "command": "cmd.exe",
      "args": ["/c", "npx", "stdio-mcp-server"]
    }
  }
}

Ejemplos de Uso

Redirigiendo Registros de Aplicaciones

Para enviar la salida de tu aplicación a la tubería:

# Unix/MacOS
your_application > /tmp/stdout_pipe

# Windows (PowerShell)
your_application > \\.\pipe\stdout_pipe

Monitoreando Múltiples Aplicaciones

Puedes redirigir registros de múltiples fuentes:

# Application 1
app1 > /tmp/stdout_pipe &

# Application 2
app2 > /tmp/stdout_pipe &

Consultando Registros

Tu IA usará la herramienta get-logs en tu cliente MCP para recuperar y filtrar registros:

// Get last 50 logs
get-logs()

// Get last 100 logs containing "error"
get-logs({ lines: 100, filter: "error" })

// Get logs since a specific timestamp
get-logs({ since: 1648675200000 }) // Unix timestamp in milliseconds

Características

• Creación y monitoreo de tuberías con nombre
• Captura y almacenamiento de registros en tiempo real
• Filtrado y recuperación de registros a través de herramientas MCP
• Historial de registros configurable (predeterminado: 100 entradas)
• Soporte multiplataforma (Windows y sistemas basados en Unix)

Ubicaciones de Tuberías con Nombre

• Windows: \\.\pipe\stdout_pipe
• Unix/MacOS: /tmp/stdout_pipe

Herramientas Disponibles

get-logs

Recupera registros de la tubería con nombre con filtrado opcional:

Parámetros:

• lines (opcional, predeterminado: 50): Número de líneas de registro a devolver
• filter (opcional): Texto para filtrar registros
• since (opcional): Marca de tiempo para obtener registros posteriores

Ejemplos de respuestas:

// Response format
{
  content: [{
    type: "text",
    text: "[2024-03-20T10:15:30.123Z] Application started\n[2024-03-20T10:15:31.456Z] Connected to database"
  }]
}

Licencia

Licencia MIT