local-only server

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

Integrations

Allows searching command history for Git operations, helping users retrieve previously executed Git commands like 'git commit'.
Provides access to shell command history, enabling users to search, explore, and retrieve previously executed commands from Bash and other shell environments.
Supports reading command history from Zsh, allowing users to access and search their Zsh command history through the MCP interface.

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

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:

Obtener comandos recientes :
Please show me my most recent shell commands.
Historial de comandos de búsqueda :
Please search my command history for 'git commit' and show me the results.
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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested