hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Servidor de terminales MCP

Un servidor de interfaz de línea de comandos seguro para el Protocolo de contexto de modelo (MCP) que permite que los modelos de IA interactúen con su terminal manteniendo la seguridad y el control.

Características

🔒 Ejecución segura de comandos con permisos configurables
📁 Operaciones del sistema de archivos dentro de las rutas permitidas
🌍 Gestión de variables de entorno
💻 Compatibilidad multiplataforma (Windows, macOS, Linux)
🔌 Soporte para conexiones de sistemas remotos mediante ejecución de comandos

Uso con Claude Desktop

Agregue la configuración del servidor a su archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "terminal": {
      "command": "npx",
      "args": [
        "@dillip285/mcp-terminal",
        "--allowed-paths",
        "/path/to/allowed/directory"
      ]
    }
  }
}

Reinicie Claude Desktop para aplicar los cambios. Ahora puede usar las funciones de terminal a través de Claude con acceso seguro a archivos y ejecución de comandos.

Herramientas disponibles

execute_command : ejecuta comandos de terminal de forma segura (incluidos SSH y comandos remotos)

Seguridad

Todas las operaciones están restringidas a rutas permitidas específicas
Los comandos se validan y se desinfectan antes de su ejecución.
Las variables de entorno se gestionan con cuidado
Manejo adecuado de errores relacionados con la seguridad

Desarrollo

# Clone the repository
git clone https://github.com/dillip285/mcp-terminal.git

# Install dependencies
npm install

# Configure npm authentication
cp .npmrc.example .npmrc
# Edit .npmrc and add your NPM_TOKEN

# Run tests
npm test

# Build the project
npm run build

Publicación

Para publicar el paquete:

Copiar .npmrc.example a .npmrc
Agregue su token de autenticación npm a .npmrc
Ejecute npm publish --access public

Nota: Nunca envíes tu archivo .npmrc con el token de autenticación. Ya está añadido a .gitignore .

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'feat: Add amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Proyectos relacionados

Apoyo

Para informes de errores y solicitudes de funciones, abra un problema .

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

execute_command

Un servidor seguro para ejecutar comandos de terminal dentro de rutas predefinidas, lo que permite la interacción segura de los modelos de lenguaje grandes con los entornos del sistema operativo.

Related Resources

Reddit Discussion about this server

MCP Terminal Server