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 previously executed shell commands.

🚀 Quick Start

The MCP Command History tool enables seamless exploration, search, and management of your shell command history via the MCP interface. You can effortlessly access, search, and retrieve previously executed shell commands.

✨ Features

• Command History Access: Programmatically access your shell command history.
• Powerful Search: Search the command history using text queries.
• Recent Commands: Quickly retrieve your most recently executed commands.
• MCP Integration: Seamlessly integrate 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 Code

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

# Install dependencies
pip install -r requirements.txt

💻 Usage Examples

Start the Server

python mcp_history_server.py

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

Use with Cursor

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

Basic Usage

1. Get Recent Commands:

   Please show me my latest shell commands.
   

2. Search Command History:

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

Advanced Usage

3. Get a Specific Command: After searching or listing recent commands, you can get a specific command by its ID.

📚 Documentation

API Reference

MCP Tools

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

MCP Resources

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

🤝 Contribution

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

📄 License

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