shellserver

Un pequeño servidor de Protocolo de Contexto de Modelo (MCP) construido con el SDK de MCP para Python (FastMCP). Expone una herramienta que ejecuta comandos de shell en la máquina donde se ejecuta el proceso del servidor.

Requisitos

• Python 3.14+ (ver pyproject.toml)

• uv para instalar y ejecutar dependencias

Related MCP server: Shell MCP Server

Configuración

Clona o copia este repositorio, luego desde la raíz del proyecto:

uv sync

Ejecución del servidor

El servidor utiliza transporte stdio (el predeterminado para FastMCP).

uv run python server.py

No envíes datos adicionales a stdout desde el proceso del servidor; MCP utiliza stdout para JSON-RPC. El registro en server.py se dirige a stderr.

Herramienta: terminal_tool

La herramienta devuelve un único bloque de texto que contiene exit_code, stdout y stderr. Si el comando supera el tiempo de espera, el proceso se termina y la respuesta indica un tiempo de espera agotado.

Conexión de un cliente (ejemplo de ejecución local)

Apunta tu host MCP a uv con este proyecto como directorio de trabajo. Ejemplo de configuración:

{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absolute/path/to/shellserver"
    }
  }
}

Ajusta el nombre de la clave y cwd para que coincidan con tu editor o cliente.

Seguridad

Este servidor ejecuta comandos de shell arbitrarios en el host. Cualquiera que pueda invocar herramientas MCP contra este servidor tiene efectivamente acceso de shell a esa máquina. Úsalo solo en hosts de confianza, con clientes de confianza y con una comprensión clara del riesgo.