MCP Command History

MCP 命令历史

通过 MCP（模型上下文协议）接口探索、搜索和管理 Shell 命令历史记录的强大工具。本项目可帮助你轻松访问、搜索和检索之前执行过的 Shell 命令。

功能

• 访问命令历史：以编程方式访问 Shell 命令历史记录
• 强大的搜索功能：使用文本查询搜索命令历史记录
• 最近执行的命令：快速检索最近执行的命令
• MCP 集成：与 Cursor 及其他兼容 MCP 的工具无缝集成

安装

前置条件

• Python 3.6 或更高版本
• 支持历史记录的 Shell（Bash、Zsh 等）

从源代码安装

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

# Install dependencies
pip install -r requirements.txt

使用方法

启动服务

python mcp_history_server.py

默认情况下，服务会从 HISTFILE 环境变量指定的位置读取 Shell 历史记录；如果未指定，则使用 ~/.bash_history。

与 Cursor 搭配使用

服务运行后，你可以在 Cursor 中使用以下 MCP 工具：

1. 获取最近执行的命令：

   Please show me my most recent shell commands.
   

2. 搜索命令历史：

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

3. 获取指定命令： 搜索或列出最近执行的命令后，你可以通过命令 ID 检索指定命令。

API 参考

MCP 工具

• search_commands(query: str)：搜索 Shell 历史记录中的命令
• get_recent_commands(limit: int = 10)：获取历史记录中最近执行的命令
• get_command(command_id: int)：根据 ID 获取指定命令

MCP 资源

• history://recent/{limit}：获取最近执行的命令（HTTP 端点）
• history://search/{query}：搜索命令（HTTP 端点）

参与贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解相关指南。

许可证

本项目基于 MIT 许可证授权，详情请参阅 LICENSE 文件。