hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Servidor MCP de terminal
El Servidor Terminal MCP es un servidor de Protocolo de Contexto de Modelo (MCP) que permite ejecutar comandos en hosts locales o remotos. Proporciona una interfaz sencilla pero potente para que los modelos de IA y otras aplicaciones ejecuten comandos del sistema, ya sea en el equipo local o en hosts remotos mediante SSH.
Características
- Ejecución de comandos locales : ejecuta comandos directamente en la máquina local
- Ejecución remota de comandos : ejecute comandos en hosts remotos a través de SSH
- Persistencia de sesión : Compatibilidad con sesiones persistentes que reutilizan el mismo entorno de terminal durante un tiempo específico (predeterminado 20 minutos)
- Variables de entorno : establezca variables de entorno personalizadas para los comandos
- Múltiples métodos de conexión : Conéctese a través de stdio o SSE (eventos enviados por el servidor)
Instalación
Instalación mediante herrería
Para instalar terminal-mcp-server para Claude Desktop automáticamente a través de Smithery :
Instalación manual
Uso
Iniciando el servidor
Iniciar el servidor en modo SSE
El modo SSE (eventos enviados por el servidor) le permite conectarse al servidor de forma remota a través de HTTP.
Puede personalizar el servidor SSE con las siguientes opciones de línea de comandos:
| Opción | Descripción | Por defecto |
|---|---|---|
--port o -p | El puerto para escuchar | 8080 |
--endpoint o -e | La ruta del punto final | /sse |
--host o -h | El host al que vincularse | host local |
Ejemplo con opciones personalizadas:
Esto iniciará el servidor y escuchará conexiones SSE en http://0.0.0.0:3000/mcp .
Pruebas con MCP Inspector
La herramienta execute_command
La herramienta execute_command es la funcionalidad principal proporcionada por Terminal MCP Server, utilizada para ejecutar comandos en hosts locales o remotos.
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| dominio | cadena | Sí | El comando a ejecutar |
| anfitrión | cadena | No | El host remoto al que conectarse. Si no se proporciona, el comando se ejecutará localmente. |
| nombre de usuario | cadena | Obligatorio cuando se especifica el host | El nombre de usuario para la conexión SSH |
| sesión | cadena | No | Nombre de sesión, predeterminado: "predeterminado". El mismo nombre de sesión reutilizará el mismo entorno de terminal durante 20 minutos. |
| entorno | objeto | No | Variables de entorno, el valor predeterminado es un objeto vacío |
Ejemplos
Ejecutar un comando localmente
Ejecución de un comando en un host remoto
Configuración con asistentes de IA
Configuración con código Roo
- Abra VSCode e instale la extensión Roo Code
- Abra el archivo de configuración de Roo Code:
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json - Agregue la siguiente configuración:
Para el modo estándar (conexión local)
Para el modo SSE (conexión remota)
Reemplace localhost:8080/sse con su dirección de servidor, puerto y punto final reales si los ha personalizado.
Configuración con Cline
- Abra el archivo de configuración de Cline:
~/.cline/config.json - Agregue la siguiente configuración:
Para el modo estándar (conexión local)
Para el modo SSE (conexión remota)
Configuración con Claude Desktop
- Abra el archivo de configuración de Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json - Agregue la siguiente configuración:
Para el modo estándar (conexión local)
Para el modo SSE (conexión remota)
Mejores prácticas
Ejecución de comandos
- Antes de ejecutar comandos, es mejor determinar el tipo de sistema (Mac, Linux, etc.)
- Utilice rutas completas para evitar problemas relacionados con las rutas
- Para las secuencias de comandos que necesitan mantener el entorno, utilice
&¶ conectar varios comandos - Para comandos de larga ejecución, considere usar
nohuposcreen/tmux
Conexión SSH
- Asegúrese de que la autenticación basada en clave SSH esté configurada
- Si falla la conexión, verifique si existe el archivo de clave (ruta predeterminada:
~/.ssh/id_rsa) - Asegúrese de que el servicio SSH se esté ejecutando en el host remoto
Gestión de sesiones
- Utilice el parámetro de sesión para mantener el entorno entre comandos relacionados
- Para operaciones que requieren entornos específicos, utilice el mismo nombre de sesión
- Tenga en cuenta que las sesiones se cerrarán automáticamente después de 20 minutos de inactividad.
Manejo de errores
- Los resultados de la ejecución del comando incluyen tanto stdout como stderr
- Verifique stderr para determinar si el comando se ejecutó correctamente
- Para operaciones complejas, agregue pasos de verificación para garantizar el éxito
Notas importantes
- Para la ejecución remota de comandos, se debe configurar previamente la autenticación basada en clave SSH
- Para la ejecución de comandos locales, los comandos se ejecutarán en el contexto del usuario que inició el servidor.
- El tiempo de espera de la sesión es de 20 minutos, después de los cuales la conexión se cerrará automáticamente.
This server cannot be installed
Un servidor MCP que permite que los modelos de IA ejecuten comandos del sistema en máquinas locales o hosts remotos a través de SSH, admitiendo sesiones persistentes y variables de entorno.