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