JinDaGe - mcp-histfile MCP Details

article

README

🚀 MCP 命令历史记录

MCP 命令历史记录是一款强大的工具，借助 MCP（模型控制协议）接口，可帮助您便捷地探索、搜索和管理 shell 命令历史记录。它让您能轻松访问、搜索和检索之前执行过的 shell 命令。

🚀 快速开始

MCP 命令历史记录允许您程序化地访问 shell 命令历史记录，可使用文本查询进行搜索，还能快速获取最新执行的命令，并且能与 Cursor 和其他兼容 MCP 的工具无缝集成。

✨ 主要特性

命令历史记录访问：可程序化地访问您的 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 工具：

获取最近的命令：
```
请显示我最新的 shell 命令。
```

搜索命令历史记录：

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

获取特定命令：在搜索或列出最近命令后，您可以按 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文件。

mcp-histfile