MCP 命令历史

一个强大的工具，用于通过MCP（模型控制协议）接口探索、搜索和管理您的shell命令历史。此项目允许您轻松访问、搜索并检索之前执行过的shell命令。

功能

• 命令历史访问：通过编程方式访问您的shell命令历史
• 强大搜索：使用文本查询搜索您的命令历史
• 最近命令：快速检索您最近执行的命令
• MCP集成：无缝集成到Cursor和其他兼容MCP的工具中

安装

预备条件

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

从源码安装

# 克隆仓库
git clone https://github.com/yourusername/mcp-cmd-history.git
cd mcp-cmd-history

# 安装依赖
pip install -r requirements.txt

使用方法

启动服务器

python mcp_history_server.py

默认情况下，服务器将从HISTFILE环境变量指定的位置读取您的shell历史记录，或者退回到~/.bash_history。

与Cursor一起使用

一旦服务器运行，您可以在Cursor中使用以下MCP工具：

1. 获取最近命令：

   请显示我最近的shell命令。
   

2. 搜索命令历史：

   请在我的命令历史中搜索'git commit'并显示结果。
   

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文件。