MCP Command History

MCP コマンド履歴

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

機能

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

インストール

前提条件

• Python 3.6 以降
• 履歴に対応したシェル（Bash、Zsh など）

ソースからインストール

# Clone the repository
git clone https://github.com/yourusername/mcp-cmd-history.git
cd mcp-cmd-history

# Install dependencies
pip install -r requirements.txt

使用方法

サーバーの起動

python mcp_history_server.py

デフォルトでは、サーバーは HISTFILE 環境変数で指定された場所からシェルの履歴を読み込みます。指定がない場合は、~/.bash_history を使用します。

Cursor での使用

サーバーを起動すると、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 の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。