Terminal History Mcp

terminal-history-mcp

Claude Code、Cline、Cursor、Zed、または任意の MCP クライアントから、シェルの履歴（zsh / bash / fish）を検索できます。ローカルのみで動作します。SQLite FTS5 を使用しています。保存前に秘密情報をマスキングします。

できること

• 「最後にステージングサーバーへ ssh したのはいつですか？」
• 「最近失敗したコマンドを表示して。」
• 「昨日 /etc/nginx で実行したコマンドは何ですか？」
• 「3 週間前に使った長い docker compose のフラグは何でしたか？」
• 「kubectl apply の前後に実行した一連のコマンドを表示して。」

インストール

npm install -g terminal-history-mcp
terminal-history-mcp index           # one-time backfill from existing history

（または、クローンから実行します：git clone … && npm install && npm run build && npm link。）

Claude Code に接続する

claude mcp add --scope user terminal-history -- terminal-history-mcp
claude mcp list

他の MCP クライアントに接続する

stdio MCP サーバーの設定を受け付けるクライアントで利用できます：

{
  "mcpServers": {
    "terminal-history": {
      "command": "terminal-history-mcp"
    }
  }
}

MCPize 経由で接続する

ローカルにインストールせず、この MCP サーバーをすぐに利用できます：

npx -y mcpize connect @HasanJahidul/terminal-history --client claude

または、こちらから接続してください：https://mcpize.com/mcp/terminal-history

作業ディレクトリと終了コードを記録する（推奨）

デフォルトでは、zsh/bash の履歴ファイルにはコマンドのみが保存されます。recent_in_dir と failed_commands を利用するには、シェルフックをインストールしてください：

terminal-history-mcp install-hook zsh    # or bash, or fish
exec $SHELL                              # reload

このフックは、~/.terminal-history-mcp/extended.log にパイプ区切りの行を追記します。再インデックス時に読み込まれます。

先にスニペットを確認するには：

terminal-history-mcp print-hook zsh

削除するには：

terminal-history-mcp uninstall-hook zsh

ツール

ツール	説明
search_history(query, limit)	すべての履歴を対象に、FTS5 のキーワード検索と前方一致検索を行います
recent_in_dir(cwd, limit)	作業ディレクトリ内の直近 N 件のコマンドを取得します（フックが必要です）
failed_commands(since_ts_ms, limit)	終了コードが 0 以外のコマンドを取得します（フックが必要です）
command_chains(query, window_ms, limit)	一致した各コマンドについて、前後 5 分以内のコマンドを一覧表示します
reindex	履歴ファイルと拡張ログを再解析します

プライバシー

すべてローカルで処理されます。DB は ~/.terminal-history-mcp/history.db に保存されます。データがアップロードされることはありません。

秘密情報は挿入前に除去されます。検出されるパターン：

• GitHub PAT（ghp_*、gho_*、…）
• OpenAI キー（sk-*）
• Slack トークン（xox[baprs]-*）
• AWS アクセスキー（AKIA…）
• Authorization: Bearer/Basic <value>
• X-*-Token: …、X-*-Key: …、X-*-Secret: … ヘッダー
• TOKEN / KEY / SECRET / PASSWORD / API_KEY を含む環境変数
• CLI フラグ --token=…、--api-key …、-k …
• URL のベーシック認証 https://user:pass@host
• JWT（eyJ.*.*）

情報漏えいを見つけた場合は、issue を作成してください。パターンをアップグレードした後にデータを消去して再インデックスするには：

rm ~/.terminal-history-mcp/history.db*
terminal-history-mcp index

開発

git clone https://github.com/hasanjahidul/terminal-history-mcp
cd terminal-history-mcp
npm install
npm run build
npm test

ライセンス

MIT — LICENSE を参照してください。