Advertise
MCP.so
Sign In

MCP Command History

@rajpdus

Repository

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

rajpdus

About MCP Command History

An MCP(Model Context Protocol) Server for retrieving and sharing your bash/zsh history with MCP Client (Cursor, Claude etc.)

MCP Command History config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-histfile": {
      "command": "python",
      "args": [
        "mcp_history_server.py"
      ]
    }
  }
}

MCP Command History tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Command History?

MCP Command History provides programmatic access, search, and management of your shell command history through the Model Context Protocol (MCP) interface. It is designed for developers who want to query and interact with their command history from MCP‑compatible tools like Cursor.

How to use MCP Command History?

Install from source with Git and pip. Start the server with python mcp_history_server.py; it reads history from the HISTFILE environment variable (default: ~/.bash_history). Once running, use MCP tools such as search_commands, get_recent_commands, and get_command from a Cursor client or any MCP‑compatible host.

Key features of MCP Command History

  • Access shell command history programmatically
  • Search history with text queries
  • Retrieve most recent commands with configurable limit
  • Get a specific command by its numeric ID
  • Seamless integration with Cursor and other MCP tools
  • Supports Bash, Zsh, and any shell with history files

Use cases of MCP Command History

  • Search for a forgotten command pattern (e.g., all git commit occurrences)
  • Quickly retrieve recently executed commands for auditing or replay
  • Obtain a specific command by ID after a search or listing
  • Integrate command history retrieval into automated workflows or AI assistants

Frequently asked questions

1

How does MCP Command History access my shell history?

It reads from the `HISTFILE` environment variable; if that is not set, it falls back to `~/.bash_history`.

2

What are the runtime requirements?

Python 3.6 or higher and a shell with history support (Bash, Zsh, etc.). No external authentication or networking beyond the MCP protocol.

3

How do I start the server?

Run `python mcp_history_server.py` in the repository directory after installing dependencies with `pip install -r requirements.txt`.

4

What MCP tools are provided?

Three tools: `search_commands(query: str)`, `get_recent_commands(limit: int = 10)`, and `get_command(command_id: int)`.

5

Can I use MCP Command History with tools other than Cursor?

Yes, any MCP‑compatible client can invoke the server’s tools and resources (e.g., `history://recent/{limit}` and `history://search/{query}`).

Comments

More Developer Tools MCP servers

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

1

Yocoolab

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools

1

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

32

Termany

thinkany-ai

Agent-Native Terminal

174

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1
Advertise