Bash History MCP

🚀 Claude Code用Atuin統合

Claude Codeとatuin間の双方向bash履歴統合機能を提供します。

🚀 クイックスタート

この統合機能を使用することで、Claude Codeが実行するbashコマンドをatuinに記録し、過去のコマンドを参照することができます。

✨ 主な機能

• Claude Codeが実行するbashコマンドをatuinに記録します。
• Claude Codeがatuinの履歴を参照して、ユーザーのコマンドパターンを学習できます。
• コマンドのタイムスタンプ、作業ディレクトリ、終了コード、実行時間などの詳細なメタデータを保存します。
• 複数のマシン間で履歴を同期できます（atuinの同期機能を有効にした場合）。

📦 インストール

前提条件

• atuinがインストールされ、設定されていること。
• Bunがインストールされていること。

書き込みフックのインストール

⚠️ 重要提示

以前にこのパッケージをインストールしており、新しいバージョンに更新する場合は、最初にBunのキャッシュをクリアしてください。

bun pm cache rm

手順1: 設定ファイルの場所を特定する

Claude Codeの設定ファイルは~/.claude/settings.jsonにあります。存在しない場合は作成してください。

mkdir -p ~/.claude
touch ~/.claude/settings.json

手順2: フックの設定を追加する

~/.claude/settings.jsonを編集し、以下の内容を追加します。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bunx github:nitsanavni/bash-history-mcp hook"
          }
        ]
      }
    ]
  }
}

既にフックが設定されている場合、既存の設定とマージしてください。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bunx github:nitsanavni/bash-history-mcp hook"
          }
        ]
      },
      // ... 他のPostToolUseフック
    ]
    // ... 他のフックタイプ (PreToolUseなど)
  }
}

手順3: Claude Codeを再起動する

次回のClaude Codeセッションでフックが有効になります。

手順4: 動作を確認する

Claudeがいくつかのbashコマンドを実行した後、以下のコマンドを実行します。

atuin history last

Claudeが実行したコマンドが表示されれば正常に動作しています。

動作原理

Claudeが各bashコマンドを実行した後、以下の手順でatuinにコマンドを記録します。

1. フックが標準入力を通じてコマンドと終了コードを含むJSONを受け取ります。
2. atuin history start "$COMMAND"を呼び出して、エントリIDを取得します。
3. atuin history end --exit $EXIT --duration 0 $IDを呼び出して、コマンドの実行を終了します。
4. atuinが利用できない場合は、エラーを無視します。

トラブルシューティング

フックが実行されていない場合

# フックが登録されているか確認する
claude --debug
# Claudeでコマンドを実行し、フックの実行ログを確認する

コマンドがatuinに表示されない場合

# atuinを手動でテストする
atuin history start "test command"
atuin history last

MCPサーバーのインストール

⚠️ 重要提示

以前にこのパッケージをインストールしており、新しいバージョンに更新する場合は、最初にBunのキャッシュをクリアしてください。

bun pm cache rm

Claude CodeがMCPサーバーを使用するように設定する

claude mcp add -s user bash-history bunx -- github:nitsanavni/bash-history-mcp mcp

または、~/.claude/settings.jsonに手動で追加します。

{
  "mcpServers": {
    "bash-history": {
      "command": "bunx",
      "args": ["github:nitsanavni/bash-history-mcp", "mcp"]
    }
  }
}

利用可能なツール

• search_history(query, limit?) - パターンに一致するコマンドを検索します。

  例: search_history("git commit", 5)
  

• get_recent_history(limit?) - 最近のコマンドを取得します。

  例: get_recent_history(10)
  

🔧 技術詳細

アーキテクチャ

書き込み: フック

Claude Codeフック → Claudeが各bashコマンドを実行した後、コマンドをatuinに書き込みます。

# bash実行後のフック呼び出し:
id=$(atuin history start "$COMMAND")
atuin history end --exit "$EXIT_CODE" --duration 0 "$id"

読み取り: MCPサーバー

MCPサーバー → Claudeがatuinの履歴を照会できます。

ツール:

• search_history(query, limit?) - パターンに一致するコマンドを検索します。
• get_recent_history(limit?) - タイムスタンプと終了コード付きの最近のコマンドを取得します。

📚 ドキュメント

実装状況

1. ✅ atuin統合の書き込みフック
2. ✅ フック統合のテスト
3. ✅ 読み取り専用atuinアクセスのMCPサーバー