mcp-histfile

MCPコマンド履歴

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

特徴

• コマンド履歴アクセス: プログラムでシェルのコマンド履歴にアクセスする
• 強力な検索: テキストクエリを使用してコマンド履歴を検索します
• 最近実行したコマンド: 最近実行したコマンドを素早く取得します
• MCP統合:カーソルやその他のMCP互換ツールとシームレスに統合します

インストール

前提条件

• Python 3.6以上
• 履歴サポート付きのシェル (Bash、Zsh など)

ソースからインストール

使用法

サーバーの起動

デフォルトでは、サーバーは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) : シェル履歴内のコマンドを検索する
• 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ファイルを参照してください。