S
soulboy06/forktape
Deterministic time-travel debugger, dual-protocol (LLM SSE + MCP) flight recorder & LangGraph counterfactual…
在 GitHub 查看 ↗链接已于 2026-11-14 核查 · HTTP 200 · 打开的是厂商自己的官网
安装与配置
客户端配置（取自该仓库的安装命令）
{
"mcpServers": {
"soulboy06-forktape": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}解析自我们于 2026-11-13 抓取的该仓库 README；我们未执行过。
command/args 来自仓库写明的安装命令；不确定时请以该项目 README 为准。
VS Code（.vscode/mcp.json —— 键名是 servers）
{
"servers": {
"soulboy06-forktape": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}VS Code 顶层键是 <code>servers</code>，其余与上面那份相同。
Claude Code（命令行）
claude mcp add --transport stdio soulboy06-forktape -- npx -y @modelcontextprotocol/server-github
Claude Code 不收 JSON 文件，用这条命令直接加。
配置项的键名以你的客户端为准：客户端与 CLI
- ★ 数取值
- 0 ★ · soulboy06/forktape · 取自 GitHub 搜索 API · （2026-11-13 20:00:50 核对）
- 来源明细
- 从该仓库的 GitHub 页面直接读取 · 条目类型：开源项目
- 收录与活跃
- 收录于 2026-11-14 · 最近见到 2026-11-14 · 共见到 1 次 · 被 2 个来源列出
- 评分构成
- 综合分 203 · 2 个来源 · repo
- 安装
npx -y @modelcontextprotocol/server-github
常见问题（答案都来自我们的记录）
怎么安装？
该仓库给出的安装命令是
npx -y @modelcontextprotocol/server-github。我们的记录里它是仓库自己提供的；不保证在你的客户端上直接可用。它适合谁 / 用来做什么？
我们把它归在这些标签下: 开源项目。标签来自条目自身，不是我们强加的分类。
谁维护它、还在更新吗？
仓库
soulboy06/forktape；我们收录于 2026-11-14；最近见到 2026-11-14。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。# 📼 ForkTape (ftk)
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Deterministic Time-Travel Debugger, Dual-Protocol (LLM SSE + MCP) Flight Recorder, and LangGraph Counterfactual Root-Cause Doctor for AI Agents.
English · 简体中文 · ForkBench-50 Benchmark · Contributing
> Trace viewers (LangSmith, Langfuse, Phoenix) show you what crashed at Step 14.
> ForkTape rewinds time to Step 5 in
## ⚡ Try the Interactive Time-Travel Studio in 10 Seconds (Zero API Keys)
ForkTape ships with an embedded React Web Studio and 4 realistic multi-step production failure tapes (42-tool MCP schema overload, 18KB Lost-in-the-Middle context rot, silent empty-RAG hallucination, and dynamic timestamp Prefix KV Cache thrashing):
bash
# Run instantly from source with uv:
git clone https://github.com/soulboy06/forktape.git
cd forktape
uv sync --extra dev
uv run forktape demo
Or once installed via pip / uv tool:
bash
pip install forktape
forktape demo
Open the printed localhost URL (http://127.0.0.1:18787) to inspect token X-rays, run the LangGraph Biopsy Doctor, fork any step with BM25 tool pruning or context compaction, compare trajectories side-by-side, and export runnable pytest suites—100% offline with zero API keys required.
## 🤔 Why ForkTape?
When a 15-step agent fails at Step 14, the root cause almost never happened at Step 14. It happened upstream—at Step 5 when a noisy tool dumped 45KB of unpruned JSON into context (Lost-in-the-Middle), or when 64 overlapping MCP tool schemas overwhelmed tool selection, or when an empty vector search caused a downstream ID hallucination.
Re-running Steps 1..13 from scratch to test every prompt or context hypothesis is:
1. Slow & Expensive: Waiting 90 seconds and burning 40k+ tokens per edit.
2. Non-Deterministic: Sampling jitter changes Step 3, invalidating your Step 5 A/B test.
3. Dangerous: Re-executing live MCP tools (stripe_refund, delete_row, send_slack_alert) triggers duplicate real-world side effects.
| Capability | Cloud Trace Viewers (LangSmith / Langfuse) | HTTP Cassettes (VCR.py) | ForkTape (ftk) |
| Zero-SDK Streaming SSE Interception | Requires SDK / OTEL wrappers | Breaks on chunked LLM SSE | Lossless OpenAI & Anthropic SSE Assembly |
| MCP (stdio + HTTP) Flight Recording | Partial / Manual spans | No stdio JSON-RPC support | Native stdio & HTTP Bridge + Dry-Run Write Sandbox |
| Time-Travel Fork @ Step K | Single-prompt playground only | Static replay only |
1. Dual-Protocol Zero-SDK Flight Recorder (forktape.interceptor)
Point any agent (LangGraph, OpenAI Agents SDK, AutoGen, CrewAI, Claude, custom loops) at ForkTape via OPENAI_BASE_URL / ANTHROPIC_BASE_URL or forktape record -- python agent.py.
Wraps local stdio MCP servers (forktape mcp-wrap -- npx ...) and HTTP MCP endpoints, recording JSON-RPC tools/list and tools/call spans while blocking destructive mutations (delete_, drop_, send_, refund_) during counterfactual dry-runs.
Automatically scrubs API keys/Bearer tokens before persisting to local SQLite WAL (.forktape/tapes.db).
2. Canonical Fingerprinting &
| Evaluation Metric | Naive Tail-Log Baseline | ForkTape (LangGraph Biopsy Doctor) |
| Exact Causal Drift-Step Localization | 0.0% | 100.0% |
| Root-Cause Category Accuracy | 22.0% | 100.0% |
English · 简体中文 · ForkBench-50 Benchmark · Contributing
> Trace viewers (LangSmith, Langfuse, Phoenix) show you what crashed at Step 14.
> ForkTape rewinds time to Step 5 in
## ⚡ Try the Interactive Time-Travel Studio in 10 Seconds (Zero API Keys)
ForkTape ships with an embedded React Web Studio and 4 realistic multi-step production failure tapes (42-tool MCP schema overload, 18KB Lost-in-the-Middle context rot, silent empty-RAG hallucination, and dynamic timestamp Prefix KV Cache thrashing):
bash
# Run instantly from source with uv:
git clone https://github.com/soulboy06/forktape.git
cd forktape
uv sync --extra dev
uv run forktape demo
Or once installed via pip / uv tool:
bash
pip install forktape
forktape demo
Open the printed localhost URL (http://127.0.0.1:18787) to inspect token X-rays, run the LangGraph Biopsy Doctor, fork any step with BM25 tool pruning or context compaction, compare trajectories side-by-side, and export runnable pytest suites—100% offline with zero API keys required.
## 🤔 Why ForkTape?
When a 15-step agent fails at Step 14, the root cause almost never happened at Step 14. It happened upstream—at Step 5 when a noisy tool dumped 45KB of unpruned JSON into context (Lost-in-the-Middle), or when 64 overlapping MCP tool schemas overwhelmed tool selection, or when an empty vector search caused a downstream ID hallucination.
Re-running Steps 1..13 from scratch to test every prompt or context hypothesis is:
1. Slow & Expensive: Waiting 90 seconds and burning 40k+ tokens per edit.
2. Non-Deterministic: Sampling jitter changes Step 3, invalidating your Step 5 A/B test.
3. Dangerous: Re-executing live MCP tools (stripe_refund, delete_row, send_slack_alert) triggers duplicate real-world side effects.
| Capability | Cloud Trace Viewers (LangSmith / Langfuse) | HTTP Cassettes (VCR.py) | ForkTape (ftk) |
| Zero-SDK Streaming SSE Interception | Requires SDK / OTEL wrappers | Breaks on chunked LLM SSE | Lossless OpenAI & Anthropic SSE Assembly |
| MCP (stdio + HTTP) Flight Recording | Partial / Manual spans | No stdio JSON-RPC support | Native stdio & HTTP Bridge + Dry-Run Write Sandbox |
| Time-Travel Fork @ Step K | Single-prompt playground only | Static replay only |
1. Dual-Protocol Zero-SDK Flight Recorder (forktape.interceptor)
Point any agent (LangGraph, OpenAI Agents SDK, AutoGen, CrewAI, Claude, custom loops) at ForkTape via OPENAI_BASE_URL / ANTHROPIC_BASE_URL or forktape record -- python agent.py.
Wraps local stdio MCP servers (forktape mcp-wrap -- npx ...) and HTTP MCP endpoints, recording JSON-RPC tools/list and tools/call spans while blocking destructive mutations (delete_, drop_, send_, refund_) during counterfactual dry-runs.
Automatically scrubs API keys/Bearer tokens before persisting to local SQLite WAL (.forktape/tapes.db).
2. Canonical Fingerprinting &
| Evaluation Metric | Naive Tail-Log Baseline | ForkTape (LangGraph Biopsy Doctor) |
| Exact Causal Drift-Step Localization | 0.0% | 100.0% |
| Root-Cause Category Accuracy | 22.0% | 100.0% |
收录徽章（可选）
想把收录标记放进 README 就复制这行，可选，不影响收录。
[](https://anclum.com/zh/s/soulboy06-forktape/)
- 来源
- github · https://github.com/soulboy06/forktape
- 按领域浏览
- 开源项目
- 收录来源
- 2 个独立来源
- 收录于
- 今天
同类推荐
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。