MCP Histfile

🚀 MCP コマンド履歴

このツールは、MCP（モデル制御プロトコル）インターフェースを通じて、シェルコマンドの履歴を探索、検索、管理するための強力なツールです。このプロジェクトを使用すると、以前に実行したシェルコマンドに簡単にアクセス、検索、取得することができます。

✨ 主な機能

• コマンド履歴へのアクセス：プログラム的にシェルコマンドの履歴にアクセスできます。
• 強力な検索機能：テキストクエリを使用して、コマンド履歴内を検索できます。
• 最近のコマンド取得：最新で実行したコマンドをすばやく取得できます。
• MCP 統合：Cursorやその他のMCP対応ツールとシームレスに統合できます。

📦 インストール

前提条件

• Python 3.6以上
• 履歴機能をサポートするシェル（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環境変数で指定された場所からシェル履歴を読み取り、指定がない場合は~/.bash_historyを使用します。

Cursorとの連携

サーバーが起動したら、Cursorで以下のMCPツールを使用できます。

1. 最近のコマンドの取得：

   最新のシェルコマンドを表示してください。
   

2. コマンド履歴の検索：

   コマンド履歴の中から'git commit'を検索し、結果を表示してください。
   

3. 特定のコマンドの取得： 検索または最近のコマンドの一覧表示後、IDで特定のコマンドを取得できます。

📚 ドキュメント

API リファレンス

MCP ツール

• search_commands(query: str)：シェル履歴内でコマンドを検索します。
• 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ファイルを参照してください。