Hindsight MCP

🚀 hindsight-mcp

hindsight-mcp 是一個用於人工智能輔助編碼的 MCP 服務器，它利用開發歷史數據來提供支持。該項目將開發數據（如 git 日誌、測試結果和 GitHub Copilot 會話）整合到一個可搜索的 SQLite 數據庫中，通過 VS Code 中的 MCP 工具調用，讓 AI 助手能夠訪問這些數據。

🚀 快速開始

前提條件

• 安裝了 GitHub Copilot 的 VS Code v1.99+
• cargo-nextest（用於測試數據攝入），可使用以下命令安裝：

cargo install cargo-nextest

安裝

使用以下命令安裝 hindsight-mcp：

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 工具來回答關於開發歷史的問題。

✨ 主要特性

• 對提交記錄和 Copilot 對話進行全文搜索
• 跟蹤與特定提交相關的測試結果
• 提供活動摘要和時間線視圖
• 自動攝入 git 和 Copilot 會話數據

📦 安裝指南

前提條件

• 安裝了 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}"]
    }
  }
}

💻 使用示例

基礎用法

在 Copilot Chat 中，切換到 Agent 模式後，你可以詢問一些問題，例如：

"What have I been working on recently?"

高級用法

你可以使用不同的 MCP 工具來完成特定的任務，例如：

"Show recent commits and test runs"  # 使用 hindsight_timeline 工具
"Find commits about authentication"  # 使用 hindsight_search 工具

📚 詳細文檔

MCP 工具

測試數據攝入

運行測試並自動攝入結果：

# 運行所有測試並攝入
hindsight-mcp test

# 測試特定包
hindsight-mcp test -p my-crate

# 預覽而不寫入數據庫
hindsight-mcp test --dry-run

test 命令會自動執行以下操作：

• 使用正確的標誌啟動 cargo nextest
• 自動檢測當前的 git 提交
• 將結果攝入到數據庫中

# 使用 stdin 模式
NEXTEST_EXPERIMENTAL_LIBTEST_JSON=1 cargo nextest run \
  --message-format libtest-json 2>/dev/null | \
  hindsight-mcp test --stdin

# 使用 ingest 命令並指定提交
NEXTEST_EXPERIMENTAL_LIBTEST_JSON=1 cargo nextest run \
  --message-format libtest-json 2>/dev/null | \
  hindsight-mcp ingest --tests --commit $(git rev-parse HEAD)

數據源

Git 和 Copilot 數據會自動攝入，測試結果需要運行 hindsight-mcp test 命令。

CLI 參考

hindsight-mcp [OPTIONS] [COMMAND]

Commands:
  ingest    從各種數據源攝入數據
  test      運行測試並攝入結果

Options:
  -d, --database <PATH>   數據庫路徑 [默認: ~/.hindsight/hindsight.db]
  -w, --workspace <PATH>  工作區路徑 [默認: 當前目錄]
  -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       顯示測試輸出

環境變量

數據庫位置

🔧 技術細節

hindsight-mcp 項目將開發數據（git 日誌、測試結果和 GitHub Copilot 會話）整合到一個可搜索的 SQLite 數據庫中。通過 VS Code 中的 MCP 工具調用，AI 助手可以訪問這些數據。項目的主要模塊包括：

• hindsight-mcp：MCP 服務器二進制文件
• hindsight-git：處理 git 日誌
• hindsight-tests：處理測試結果
• hindsight-copilot：解析 Copilot 會話

📄 許可證

本項目採用 MIT 許可證。