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

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

"¿Qué archivos hay en el directorio actual?"
"Muéstrame el contenido del archivo README.md"
"¿Cuál es la fecha actual del sistema?"
"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.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Un servidor de protocolo de contexto de modelo que permite a los LLM ejecutar comandos de shell y recibir su salida de manera controlada.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Ethers Wallet
crazyrabbitLTC
A
security
A
license
A
quality
A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
Last updated -
31
323
2
TypeScript
MIT License
MCP Python Interpreter
yzfly
A
security
F
license
A
quality
A Model Context Protocol server that allows LLMs to interact with Python environments, execute code, and manage files within a specified working directory.
Last updated -
9
42
Python
Playwright MCP Server
pvinis
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to interact with web pages, take screenshots, generate test code, scrape web pages, and execute JavaScript in a real browser environment.
Last updated -
29
10
1
TypeScript
MIT License
PermShell MCP
mcollina
-
security
-
license
-
quality
A Model Context Protocol server that allows LLMs to execute shell commands with explicit user permission through desktop notifications.
Last updated -
1
TypeScript
MIT License

View all related MCP servers

Shell MCP Server