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
Para comprobar si hay problemas de pelusa:
Para corregir automáticamente problemas de pelusa y formato:
O manualmente:
npm run lint:fix # Fix linting issues
npm run format # Format code
Pruebas
Versión del SDK de MCP
Este proyecto utiliza MCP SDK versión 1.0.1.