AI导哈

命令历史管理工具

一个通过MCP接口探索、搜索和管理shell命令历史的强大工具，可程序化访问、搜索和检索历史命令。

  • by rajpdus
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 rajpdus/mcp-histfile

使用说明

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

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

与光标一起使用

服务器运行后，您可以在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端点）

贡献

欢迎投稿！请看 贡献.md 作为指导方针。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP