Historial del comando MCP

Una potente herramienta para explorar, buscar y gestionar el historial de comandos de shell mediante la interfaz MCP (Protocolo de Control de Modelos). Este proyecto permite acceder, buscar y recuperar fácilmente los comandos de shell ejecutados previamente.

Características

• Acceso al historial de comandos : acceda a su historial de comandos de shell mediante programación

• Búsqueda potente : busque en su historial de comandos con consultas de texto

• Comandos recientes : recupere rápidamente sus comandos ejecutados más recientemente

• Integración con MCP : se integra perfectamente con Cursor y otras herramientas compatibles con MCP

Related MCP server: Super Shell MCP Server

Instalación

Prerrequisitos

• Python 3.6 o superior

• Un shell con soporte de historial (Bash, Zsh, etc.)

Instalar desde la fuente

# Clone the repository
git clone https://github.com/yourusername/mcp-cmd-history.git
cd mcp-cmd-history

# Install dependencies
pip install -r requirements.txt

Uso

Iniciando el servidor

python mcp_history_server.py

De forma predeterminada, el servidor leerá el historial de shell desde la ubicación especificada en la variable de entorno HISTFILE o recurrirá a ~/.bash_history .

Uso con cursor

Una vez que el servidor esté en ejecución, puede utilizar las siguientes herramientas MCP en Cursor:

1. Obtener comandos recientes :

   Please show me my most recent shell commands.

2. Historial de comandos de búsqueda :

   Please search my command history for 'git commit' and show me the results.

3. Obtener comando específico : puede recuperar un comando específico por su ID después de buscar o enumerar comandos recientes.

Referencia de API

Herramientas MCP

• search_commands(query: str) : busca comandos en el historial del shell

• get_recent_commands(limit: int = 10) : Obtener los comandos más recientes del historial

• get_command(command_id: int) : Obtener un comando específico por ID

Recursos de MCP

• history://recent/{limit} : Obtener comandos recientes (punto final HTTP)

• history://search/{query} : Buscar comandos (punto final HTTP)

Contribuyendo

¡Agradecemos sus contribuciones! Consulte las normas en CONTRIBUTING.md .

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.