MCP.so
登录

MCP Command History

@rajpdus

基本信息

分类

开发工具

许可证

MIT

传输方式

stdio

作者

rajpdus

关于 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 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

MCP Command History 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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}`).

评论

开发工具 分类下的更多 MCP 服务器