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

F

license - not found

-

quality - not tested

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.