Hindsight MCP

事后诸葛亮

利用开发历史进行人工智能辅助编码的MCP服务器。

概述

事后诸葛亮 将开发数据（git日志、测试结果和GitHub Copilot会话）整合到一个可搜索的SQLite数据库中，使AI助手可以通过VS Code中的MCP工具调用访问它。

主要特点：

• 跨提交和复制对话的全文搜索
• 跟踪与特定提交相关的测试结果
• 活动摘要和时间线视图
• 自动接收git和Copilot会话

快速开始

先决条件

• VS代码v1.99+ 使用GitHub Copilot
• 下一个货物 （用于测试摄入）： cargo install cargo-nextest

安装

cargo install hindsight-mcp

配置VS代码

创建 .vscode/mcp.json 在您的项目中：

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

验证设置

1. 打开VS代码命令面板(Cmd+Shift+P)
2. 跑 “MCP:列出服务器”
3. 确认 hindsight 已列出
4. 在Copilot聊天中，切换到 代理 模式
5. 问： *“我最近在做什么？”*

就是这样！Copilot将使用后见之明工具来回答有关您的发展历史的问题。

MCP工具

Tool Arguments Reference

后视时间线

• limit （int）：最大事件数，默认值50
• workspace （string）：按路径筛选

后视搜索

• query （string）：搜索查询（必填）
• source （string）：“全部”、“提交”或“消息”
• limit （int）：最大结果，默认值为20

后视失败测试

• limit （int）：最大测试数，默认值50
• workspace （string）：按路径筛选
• commit （string）：按SHA筛选

后视_活动_总结

• days （int）：总结天数，默认为7天

后视_承诺_细节

• sha （string）：提交SHA（必填）

妊娠期后视镜

• workspace （string）：摄取路径（必填）
• source （string）：“git”、“副驾驶”或“all”
• incremental （bool）：只有新数据，默认为true
• limit （int）：最大项目数

试验摄入

运行测试并自动摄取结果：

# Run all tests and ingest
hindsight-mcp test

# Test specific package
hindsight-mcp test -p my-crate

# Preview without writing to database
hindsight-mcp test --dry-run

这 test 命令自动执行：

• 生成物 cargo nextest 带有正确的标志
• 自动检测当前git提交
• 将结果输入数据库

CI / Advanced Usage

对于CI管道或自定义next est调用：

# Using stdin mode
NEXTEST_EXPERIMENTAL_LIBTEST_JSON=1 cargo nextest run \
  --message-format libtest-json 2>/dev/null | \
  hindsight-mcp test --stdin

# Using ingest command with explicit commit
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    Ingest data from various sources
  test      Run tests and ingest results

Options:
  -d, --database 
   Database path [default: ~/.hindsight/hindsight.db]
  -w, --workspace 
  Workspace path [default: current directory]
  -v, --verbose           Debug logging
  -q, --quiet             Errors only
      --skip-init         Skip database init
  -h, --help              Print help
  -V, --version           Print version

Test Subcommand Options

hindsight-mcp test [OPTIONS] [-- ...]

Options:
  -p, --package 
     Package(s) to test
      --bin          Binary(ies) to run
  -E, --filter      Filter expression
      --stdin             Read from stdin
      --dry-run           Preview only
      --no-commit         Do not link to commit
      --commit       Explicit commit SHA
      --show-output       Show test output

环境变量

数据库位置

故障排除

发展

Building from Source

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

Running Tests

cargo install cargo-nextest
cargo nextest run --workspace

Workspace Structure

hindsight/
├── crates/
│   ├── hindsight-mcp/      # MCP server binary
│   ├── hindsight-git/      # Git log processing
│   ├── hindsight-tests/    # Test result processing
│   └── hindsight-copilot/  # Copilot session parsing

Fuzzing

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

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

许可证

麻省理工学院