Servidor de shell MCP
Un servidor que utiliza el Protocolo de Contexto de Modelo (MCP) para ejecutar comandos de shell. Funciona como un puente que permite a los agentes de IA ejecutar comandos de shell de forma segura.
Características
- Ejecutar comandos de shell (soporte de una sola línea y de varias líneas)
- Soporte para varios shells (bash, zsh, fish, powershell, cmd, etc.)
- Manejo y registro detallado de errores
- Compatible con MCP Inspector
Instalación
Desde npm (como usuario)
# Using npm
npm install -g @mkusaka/mcp-shell-server
# Using yarn
yarn global add @mkusaka/mcp-shell-server
# Using pnpm
pnpm add -g @mkusaka/mcp-shell-server
Desde la fuente (para desarrollo)
# Clone the repository
git clone https://github.com/mkusaka/mcp-shell-server.git
cd mcp-shell-server
# Install dependencies
pnpm install
# Build the project
pnpm build
Configuración de MCP
Configuración del cursor
Agregue lo siguiente a su archivo de configuración de Cursor ( ~/.cursor/config.json ):
{
"mcpServers": {
"shell": {
"command": "npx",
"args": ["-y", "@mkusaka/mcp-shell-server"]
}
}
}
Integración de Cline
Cline es una extensión de VS Code que permite usar servidores MCP con Claude AI. Para configurar este servidor de shell MCP con Cline:
- Abra el archivo de configuración de Cline MCP:
- macOS:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - Windows:
%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - Linux:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Agregue la configuración MCP del servidor shell:
{
"mcpServers": {
"shell": {
"command": "npx",
"args": ["-y", "@mkusaka/mcp-shell-server"],
"disabled": false,
"autoApprove": []
}
}
}
{
"mcpServers": {
"shell": {
"command": "node",
"args": ["/path/to/mcp-shell-server/dist/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
Configuración de reglas
Añade lo siguiente a las reglas o indicaciones de tu asistente de IA:
You have MCP Shell tools at your disposal. Follow these rules regarding Shell tool usage:
1. ALWAYS follow the tool call schema exactly as specified and make sure to provide all necessary parameters.
2. **NEVER refer to tool names when speaking to me.** For example, instead of saying 'I need to use the shell_exec tool to run this command', just say 'I'll run that command for you'.
3. Only use Shell tools when they are necessary. If my task is general or you already know the answer, just respond without calling tools.
4. When I ask you to execute shell commands, use the appropriate tool to:
- Run single-line commands
- Run multi-line commands (using heredoc syntax when appropriate)
- Execute file operations, git commands, or system utilities
- Provide system information when relevant
5. Always be careful with shell commands that might modify the system, and explain what the command will do before executing it.
6. If a shell command produces an error, explain what went wrong in simple terms and suggest ways to fix it.
Uso
Ejecución directa
node dist/index.js
# or as an executable
./dist/index.js
Modo de desarrollo
Pruebas con MCP Inspector
Argumentos de la línea de comandos
-s, --shell <shell> Specify the path to the shell to use
-w, --working-dir <directory> Specify the working directory for command execution
-h, --help Display help message
-V, --version Display version information
Referencia de herramientas
shell_exec
Ejecuta comandos en el shell especificado.
Parámetros:
command (cadena, obligatorio): el comando de shell a ejecutarworkingDir (cadena, opcional): el directorio de trabajo donde ejecutar el comando. Debe estar bajo $HOME.
Referencia de recursos
El servidor proporciona la siguiente información del sistema como recursos:
nombre de host
Devuelve el nombre de host del sistema.
URI: hostname://
Devuelve la plataforma del sistema operativo.
URI: platform://
caparazón
Devuelve la ruta del shell que utiliza el servidor.
URI: shell://
nombre de usuario
Devuelve el nombre de usuario actual.
URI: username://
Devuelve información completa del sistema en formato JSON, que incluye:
- nombre de host
- plataforma
- caparazón
- nombre de usuario
- Número de CPU
- Memoria total
- Memoria libre
- Tiempo de actividad del sistema
Ejemplos de uso
Ejecución de comandos básicos
{
"name": "shell_exec",
"parameters": {
"command": "echo Hello, World!"
}
}
Ejecución de comandos multilínea (Heredoc)
{
"name": "shell_exec",
"parameters": {
"command": "cat << EOF | grep 'example'\nThis is an example text.\nAnother line without the keyword.\nEOF"
}
}
Desarrollo
Estructura del proyecto
src/
├── index.ts # Main entry point
└── shell-server/
├── index.ts # Shell server implementation
└── lib/
└── logger.ts # Logging configuration
Explotación florestal
Los registros se escriben en el archivo mcp-shell.log .
Licencia
Instituto Tecnológico de Massachusetts (MIT)