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