Hindsight MCP

🚀 hindsight-mcp

開発履歴を活用したAI支援コーディング用のMCPサーバー

🚀 クイックスタート

前提条件

• GitHub Copilotを搭載した VS Code v1.99以降
• cargo-nextest (テスト取り込み用): cargo install cargo-nextest

インストール

cargo install hindsight-mcp

VS Codeの設定

プロジェクト内に .vscode/mcp.json を作成します。

{
  "servers": {
    "hindsight": {
      "type": "stdio",
      "command": "hindsight-mcp",
      "args": ["--workspace", "${workspaceFolder}"]
    }
  }
}

設定の確認

1. VS Codeのコマンドパレット (Cmd+Shift+P) を開きます。
2. "MCP: List Servers" を実行します。
3. hindsight がリストに表示されていることを確認します。
4. Copilot Chatで Agent モードに切り替えます。
5. "What have I been working on recently?" と質問します。

以上です！Copilotがhindsightツールを使用して、開発履歴に関する質問に回答します。

✨ 主な機能

hindsight-mcp は開発データ（gitログ、テスト結果、GitHub Copilotセッション）を検索可能なSQLiteデータベースにまとめ、VS Code内のMCPツール呼び出しを通じてAIアシスタントがアクセスできるようにします。

• コミットとCopilot会話の全文検索
• 特定のコミットに関連付けられたテスト結果の追跡
• アクティビティの要約とタイムライン表示
• gitとCopilotセッションの自動取り込み

📦 インストール

cargo install hindsight-mcp

💻 使用例

基本的な使用法

# 全てのテストを実行して結果を取り込む
hindsight-mcp test

# 特定のパッケージをテストする
hindsight-mcp test -p my-crate

# データベースに書き込まずにプレビューする
hindsight-mcp test --dry-run

高度な使用法

# CIパイプラインやカスタムnextest呼び出しの場合
# stdinモードを使用する
NEXTEST_EXPERIMENTAL_LIBTEST_JSON=1 cargo nextest run \
  --message-format libtest-json 2>/dev/null | \
  hindsight-mcp test --stdin

# 明示的なコミットで取り込みコマンドを使用する
NEXTEST_EXPERIMENTAL_LIBTEST_JSON=1 cargo nextest run \
  --message-format libtest-json 2>/dev/null | \
  hindsight-mcp ingest --tests --commit $(git rev-parse HEAD)

📚 ドキュメント

MCPツール

データソース

GitとCopilotのデータは自動的に取り込まれます。テスト結果は hindsight-mcp test を実行する必要があります。

CLIリファレンス

hindsight-mcp [OPTIONS] [COMMAND]

Commands:
  ingest    様々なソースからデータを取り込む
  test      テストを実行して結果を取り込む

Options:
  -d, --database <PATH>   データベースのパス [default: ~/.hindsight/hindsight.db]
  -w, --workspace <PATH>  ワークスペースのパス [default: カレントディレクトリ]
  -v, --verbose           デバッグログを表示
  -q, --quiet             エラーのみ表示
      --skip-init         データベースの初期化をスキップ
  -h, --help              ヘルプを表示
  -V, --version           バージョンを表示

hindsight-mcp test [OPTIONS] [-- <NEXTEST_ARGS>...]

Options:
  -p, --package <PKG>     テストするパッケージ
      --bin <BIN>         実行するバイナリ
  -E, --filter <EXPR>     フィルタ式
      --stdin             標準入力から読み取る
      --dry-run           プレビューのみ
      --no-commit         コミットにリンクしない
      --commit <SHA>      明示的なコミットSHA
      --show-output       テスト出力を表示

環境変数

データベースの場所

トラブルシューティング

開発

git clone https://github.com/Rbfinch/hindsight-mcp.git
cd hindsight-mcp
cargo build --release

cargo install cargo-nextest
cargo nextest run --workspace

hindsight/
├── crates/
│   ├── hindsight-mcp/      # MCPサーバーバイナリ
│   ├── hindsight-git/      # Gitログの処理
│   ├── hindsight-tests/    # テスト結果の処理
│   └── hindsight-copilot/  # Copilotセッションの解析

cd crates/hindsight-tests
cargo +nightly fuzz run fuzz_nextest_run

cd crates/hindsight-copilot
cargo +nightly fuzz run fuzz_session_json

📄 ライセンス

MIT