Bash MCP (Programa de control maestro)

Una aplicación TypeScript que permite a Claude ejecutar comandos bash de forma segura con medidas de seguridad. Este proyecto implementa el Protocolo de Contexto de Modelo (MCP) para proporcionar una interfaz segura para ejecutar comandos bash desde asistentes de IA como Claude.

Características

Ejecutar comandos bash en un entorno controlado
Soporte para ejecución de comandos tanto con estado como sin estado (interactivos)
Medidas de seguridad:
- Comandos incluidos en la lista blanca
- Directorios incluidos en la lista blanca
- Validación de comandos
- Sanitización de salida
Gestión de sesiones para comandos interactivos
Registro completo
Implementación del servidor MCP para la integración de IA

Instalación

npm install
npm run build

Configuración

La configuración se almacena en config/default.json . Puedes personalizarla:

Comandos permitidos
Directorios permitidos
Configuración de la sesión
Configuración de seguridad
Configuración de registro

Ejemplo de configuración:

{
  "allowedCommands": ["ls", "cat", "echo", "pwd"],
  "allowedDirectories": ["/tmp", "/home"],
  "session": {
    "timeout": 300,
    "maxActiveSessions": 5,
    "defaultMode": "stateless"
  },
  "security": {
    "validateCommandsStrictly": true,
    "sanitizeOutput": true,
    "maxOutputSize": 1048576,
    "commandTimeout": 30
  },
  "logging": {
    "level": "info",
    "file": "logs/bash-mcp.log",
    "maxSize": 10485760,
    "maxFiles": 5
  }
}

Uso

Como biblioteca

Ejecución de comandos simples

import { executeCommand } from 'bash-mcp';

const result = await executeCommand('ls -la', { cwd: '/home/user' });
console.log(result.output);

Sesiones interactivas

import { initBashMCP } from 'bash-mcp';

const mcp = await initBashMCP();

// Create a session
const session = mcp.createSession('/home/user');
const sessionId = session.sessionId;

// Execute a command in the session
const result1 = await mcp.executeCommand('ls -la', { sessionId });
console.log(result1.output);

// Send input to the session
const result2 = await mcp.sendInput({ sessionId, input: 'echo "Hello, world!"' });
console.log(result2.output);

// Close the session when done
mcp.closeSession(sessionId);

Como servidor MCP

Este proyecto incluye una implementación de servidor MCP que se puede utilizar con Claude Desktop u otros clientes MCP:

# Start the TypeScript MCP server
npm run mcp

# Start the JavaScript MCP server
npm run mcp-js

# Start with MCP Inspector
npm run inspector

Consulte MCP.md para obtener documentación detallada sobre la implementación del servidor MCP.

Consideraciones de seguridad

Este MCP está diseñado teniendo en cuenta la seguridad, pero es importante:

Mantenga la lista de comandos y directorios permitidos lo más restrictiva posible
Revisar y actualizar periódicamente la configuración
Supervisar los registros para detectar actividad sospechosa
Mantenga el MCP y sus dependencias actualizados

Desarrollo

Edificio

npm run build

Pelusa y formato

Para comprobar si hay problemas de pelusa:

npm run lint

Para corregir automáticamente problemas de pelusa y formato:

./fix-lint.sh

O manualmente:

npm run lint:fix  # Fix linting issues
npm run format    # Format code

Pruebas

npm test

Versión del SDK de MCP

Este proyecto utiliza MCP SDK versión 1.0.1.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

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

Una aplicación TypeScript que permite a Claude ejecutar de forma segura comandos bash con medidas de seguridad, proporcionando una interfaz segura a través del Protocolo de Contexto de Modelo.

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
131
MIT License
Windows CLI MCP Server
simon-ami
A
security
A
license
A
quality
A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
Last updated -
9
256
248
MIT License
Shell MCP Server
hdresearch
A
security
A
license
A
quality
A Node.js implementation of the Model Context Protocol that provides secure shell command execution capabilities, allowing AI models like Claude to run shell commands in a controlled environment with built-in security measures.
Last updated -
1
117
37
MIT License
Bash MCP (Master Control Program)
yannbam
-
security
F
license
-
quality
A TypeScript application that allows Claude to safely execute bash commands with security safeguards including whitelisted commands, directories, and comprehensive logging.
Last updated -

View all related MCP servers

Bash MCP

Bash MCP (Programa de control maestro)

Características

Instalación

Configuración

Uso

Como biblioteca

Ejecución de comandos simples

Sesiones interactivas

Como servidor MCP

Consideraciones de seguridad

Desarrollo

Edificio

Pelusa y formato

Pruebas

Versión del SDK de MCP

Related MCP Servers

mcp-shell-server

Windows CLI MCP Server

Shell MCP Server

Bash MCP (Master Control Program)

Appeared in Searches

New MCP Servers

MCP directory API