Servidor MCP de Shell

Un servidor de Protocolo de Contexto de Modelo que proporciona capacidades de ejecución de comandos de shell. Este servidor permite a los LLM ejecutar comandos de shell y recibir su salida de forma controlada.

Herramientas disponibles

• execute_command - Ejecuta un comando de shell y devuelve su salida

  • Argumentos obligatorios:

    • command (cadena): comando de Shell a ejecutar

  • Devoluciones:

    • Resultado del comando que contiene:

      • command : El comando ejecutado

      • output : Salida combinada de stdout y stderr

      • return_code : Código de retorno de ejecución del comando

Related MCP server: PermShell MCP

Instalación

Uso de uv (recomendado)

Al usar uv no se requiere ninguna instalación específica. Usaremos uvx para ejecutar directamente mcp-server-shell .

Uso de PIP

Alternativamente, puede instalar mcp-server-shell a través de pip:

pip install mcp-server-shell

Después de la instalación, puedes ejecutarlo como un script usando:

python -m mcp_server_shell

Configuración

Configurar para Claude.app

Añade a tu configuración de Claude:

"mcpServers": {
  "shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
}

"mcpServers": {
  "shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
}

Configurar para Zed

Añade a tu configuración Zed settings.json:

"context_servers": {
  "mcp-server-shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
},

"context_servers": {
  "mcp-server-shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
},

Ejemplos de interacciones

Ejecutar un comando de shell:

{
  "name": "execute_command",
  "arguments": {
    "command": "ls -la"
  }
}

Respuesta:

{
  "command": "ls -la",
  "output": "total 24\ndrwxr-xr-x  5 user  group   160 Jan  1 12:00 .\ndrwxr-xr-x  3 user  group    96 Jan  1 12:00 ..",
  "return_code": 0
}

Depuración

Puede usar el inspector MCP para depurar el servidor. Para instalaciones uvx:

npx @modelcontextprotocol/inspector uvx mcp-server-shell

O si ha instalado el paquete en un directorio específico o está desarrollando en él:

cd path/to/servers/src/shell
npx @modelcontextprotocol/inspector uv run mcp-server-shell

Ejemplos de preguntas para Claude

1. "¿Qué archivos hay en el directorio actual?"

2. "Muéstrame el contenido del archivo README.md"

3. "¿Cuál es la fecha actual del sistema?"

4. "Comprueba si Python está instalado y muestra su versión"

Consideraciones de seguridad

⚠️ Advertencia : Este servidor ejecuta comandos de shell directamente en su sistema. Úselo con precaución e implemente las medidas de seguridad adecuadas para evitar la ejecución no autorizada o peligrosa de comandos.

Contribuyendo

Invitamos a todos a contribuir para expandir y mejorar mcp-server-shell. Ya sea que desee agregar nuevas funciones, mejorar la seguridad o la documentación, su opinión es valiosa.

Para ver ejemplos de otros servidores MCP y patrones de implementación, consulte: https://github.com/modelcontextprotocol/servers

¡Aceptamos solicitudes de incorporación de cambios! Siéntete libre de contribuir con nuevas ideas, correcciones de errores o mejoras para que mcp-server-shell sea aún más potente y útil.

Licencia

mcp-server-shell está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.