MCP Histfile

🚀 MCP 命令历史记录

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

🚀 快速开始

MCP 命令历史记录允许您通过 MCP 接口探索、搜索和管理 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 工具：

请显示我最新的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 文件。