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.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

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

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

Related MCP Servers

mcp-shell-server
tumf
A
security
A
license
A
quality
A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
Last updated -
1
74
Python
MIT License
mcp-wcgw
rusiaaman
-
security
A
license
-
quality
Shell and file edit capabilities tightly coupled to provide a powerful coding experience. You can work with different modes: architect and code-writer for separate plan and implementation phase. You can get it to invoke any cli command, e.g., compiling, type checking, linting, github cli, python
Last updated -
494
Python
Apache 2.0
Shell MCP Server
blazickjp
-
security
A
license
-
quality
A secure server that enables AI applications to execute shell commands in specified directories, supporting multiple shell types (bash, sh, cmd, powershell) with built-in security features like directory isolation and timeout control.
Last updated -
9
Python
Apache 2.0
Specif-ai MCP Server
vj-presidio
A
security
F
license
A
quality
A CLI tool that runs a Model Context Protocol server over stdio, enabling interaction with specification documents like business requirements, product requirements, and user stories for the Specif-ai platform.
Last updated -
9
0
TypeScript

View all related MCP servers

mcp-cli-exec MCP Server