local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables running shell commands with structured output, including support for single commands, chained commands, or arrays of commands in specified working directories. Returns detailed execution results with stdout, stderr, exit codes, and execution duration.

mcp-cli-exec Servidor MCP

Un potente servidor MCP de ejecución de comandos CLI que permite ejecutar comandos de shell con salida estructurada. Este paquete se centra específicamente en la funcionalidad de ejecución de comandos, lo que lo diferencia de otras herramientas MCP CLI.

Características

Herramientas

cli-exec-raw

Ejecutar un comando CLI sin formato y devolver una salida estructurada

Toma una cadena de comando y un tiempo de espera opcional (predeterminado: 5 minutos)
Devuelve resultados de ejecución detallados, incluidos stdout, stderr y código de salida.
Maneja los errores con elegancia con respuestas de error estructuradas

cli-exec

Ejecutar uno o más comandos CLI en un directorio de trabajo específico

Admite comandos individuales, comandos encadenados o una matriz de comandos
Todos los comandos se ejecutan en el directorio de trabajo especificado
Devuelve resultados detallados para cada comando:
- Estado de éxito/fracaso
- Código de salida
- stdout y stderr (códigos ANSI eliminados)
- Duración de la ejecución
- Directorio de trabajo
Se detiene ante el primer fallo del comando
Tiempo de espera opcional por comando (predeterminado: 5 minutos)

Nota: Debido a las limitaciones del contexto de ejecución, cada comando se ejecuta de forma independiente. Los cambios de directorio (cd) dentro de los comandos no afectan a los comandos posteriores. Todos los comandos se ejecutan en el directorio de trabajo especificado inicialmente.

Formato de salida

Los comandos devuelven resultados estructurados que incluyen:

Estado de éxito/fracaso
Código de salida
stdout y stderr (con códigos ANSI eliminados)
Duración de la ejecución
Directorio de trabajo
Información detallada del error si corresponde

Ejemplo de uso

cli-exec-raw

Ejecución de comando simple:

{
  "command": "echo Hello World"
}

Con tiempo de espera:

{
  "command": "long-running-script.sh",
  "timeout": 300000
}

cli-exec

Comando único en un directorio específico:

{
  "workingDirectory": "/path/to/project",
  "commands": "npm install"
}

Múltiples comandos (todos se ejecutan en el mismo directorio de trabajo):

{
  "workingDirectory": "C:\\project",
  "commands": [
    "dir /b",
    "npm run build"
  ]
}

Instalación

Opcionalmente instalar desde npm:

npm install -g mcp-cli-exec
# or with pnpm
pnpm add -g mcp-cli-exec

O simplemente usa npx en tu configuración

Para la extensión Cline VSCode

Agregar a %APPDATA%/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json :

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "npx",
      "args": ["-y", "mcp-cli-exec"]
    }
  }
}

Para Claude Desktop

Agregue al archivo de configuración apropiado:

Windows: %APPDATA%/Claude/claude_desktop_config.json MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "npx",
      "args": ["-y", "mcp-cli-exec"]
    }
  }
}

Configuración especial de Windows

Si encuentra el problema de surgimiento de ENOENT npx en Windows, use esta configuración alternativa que especifica las rutas completas:

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "C:\\Users\\jim\\AppData\\Roaming\\nvm\\v22.1.0\\node.exe",
      "args": [
        "C:\\Users\\jim\\AppData\\Roaming\\npm\\node_modules\\npm\\bin\\npx-cli.js",
        "-y",
        "mcp-cli-exec"
      ]
    }
  }
}

Desarrollo

Instalar dependencias:

pnpm install

Construir el servidor:

pnpm run build

Para desarrollo con reconstrucción automática:

pnpm run watch

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. El Inspector MCP ofrece útiles herramientas de depuración:

pnpm run inspector

Esto le proporcionará una URL para acceder al inspector en su navegador, donde podrá:

Ver todos los mensajes de MCP
Inspeccionar las cargas útiles de solicitud/respuesta
Pruebe herramientas de forma interactiva
Supervisar el estado del servidor

Manejo de errores

El servidor incluye un manejo integral de errores:

Validación de entrada para todos los parámetros de la herramienta
Respuestas de error estructuradas
Manejo del tiempo de espera del comando
Validación del directorio de trabajo
Eliminación de código ANSI para una salida limpia

Detalles técnicos

Desarrollado con TypeScript y el SDK de MCP
Utiliza execa para una ejecución confiable de comandos
Tiempo de espera del comando predeterminado: 5 minutos
Admite sistemas Windows y similares a Unix (utilice los comandos adecuados para su sistema operativo, por ejemplo, 'dir' vs 'ls')
Ejecuta comandos secuencialmente, deteniéndose en el primer fallo
Cada comando se ejecuta independientemente en el directorio de trabajo especificado

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Un servidor de ejecución de comandos CLI que permite ejecutar comandos de shell con salida estructurada, proporcionando resultados de ejecución detallados que incluyen stdout, stderr, código de salida y duración de la ejecución.

Related Resources

Reddit Discussion about this server

mcp-cli-exec MCP Server

Integrations

mcp-cli-exec Servidor MCP

Características

Herramientas

cli-exec-raw

cli-exec

Formato de salida

Ejemplo de uso

cli-exec-raw

cli-exec

Instalación

Para la extensión Cline VSCode

Para Claude Desktop

Configuración especial de Windows

Desarrollo

Depuración

Manejo de errores

Detalles técnicos

Tools

Related Resources

Appeared in Searches