Servidor manual de Unix (MCP)

Un servidor MCP que proporciona documentación de comandos Unix directamente dentro de las conversaciones de Claude.

Características

• Obtener documentación de comandos : recuperar páginas de ayuda, páginas de manual e información de uso de comandos de Unix

• Lista de comandos comunes : descubre los comandos disponibles en tu sistema, categorizados por función

• Comprobar existencia de comando : verificar si un comando específico está disponible y obtener información de su versión

Related MCP server: MCP Server for FTP Access

Instalación

Prerrequisitos

• Python 3.13+

• Claude Desktop o cualquier cliente compatible con MCP

Configuración

1. Clonar este repositorio

2. Instalar el paquete:

pip install -e .
# or
uv install -e .

3. Instalar el servidor en Claude Desktop:

mcp install unix_manual_server.py
# uv
uv run mcp install unix_manual_server.py

Uso

Una vez instalado, puedes utilizar las herramientas del servidor directamente en Claude:

Obtener la documentación del comando

I need help with the grep command. Can you show me the documentation?

Lista de comandos comunes

What Unix commands are available on my system?

Comprobar si existe un comando

Is the awk command available on my system?

Desarrollo

Para probar el servidor localmente sin instalarlo en Claude:

mcp dev unix_manual_server.py

Seguridad

El servidor toma precauciones para evitar la inyección de comandos mediante:

• Validación de nombres de comandos contra un patrón de expresiones regulares

• Ejecutar comandos directamente sin usar shell

• Establecer tiempos de espera en todas las ejecuciones de comandos

• Solo verificar la documentación, nunca ejecutar comandos arbitrarios

Explotación florestal

Los registros se guardan en unix-manual-server.log en el mismo directorio que el script, lo cual resulta útil para la depuración.

• Utilice @modelcontextprotocol/inspector con npx bajo el capó.

uv run mcp dev unix_manual_server.py

npx @modelcontextprotocol/inspector uv run unix_manual_server.py

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Creado con el SDK de Python de MCP. Para más información sobre MCP, visite