mcp-histfile

MCP Command History

A powerful tool for exploring, searching, and managing your shell command history through the MCP (Model Control Protocol) interface. This project allows you to easily access, search, and retrieve your previously executed shell commands.

Features

• Command History Access: Access your shell command history programmatically
• Powerful Search: Search through your command history with text queries
• Recent Commands: Quickly retrieve your most recently executed commands
• MCP Integration: Seamlessly integrates with Cursor and other MCP-compatible tools

Installation

Prerequisites

• Python 3.6 or higher
• A shell with history support (Bash, Zsh, etc.)

Install from Source

Usage

Starting the Server

By default, the server will read your shell history from the location specified in the HISTFILE environment variable, or fall back to ~/.bash_history.

Using with Cursor

Once the server is running, you can use the following MCP tools in Cursor:

1. Get Recent Commands:
   Please show me my most recent shell commands.
2. Search Command History:
   Please search my command history for 'git commit' and show me the results.
3. Get Specific Command: You can retrieve a specific command by its ID after searching or listing recent commands.

API Reference

MCP Tools

• search_commands(query: str): Search for commands in shell history
• get_recent_commands(limit: int = 10): Get the most recent commands from history
• get_command(command_id: int): Get a specific command by ID

MCP Resources

• history://recent/{limit}: Get recent commands (HTTP endpoint)
• history://search/{query}: Search for commands (HTTP endpoint)

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.