Claude-labbook

MCP开发工具

提供方 anthonylee991 · 包名 claude-labbook

开发工具 stdio · 本地进程 会话登录 社区 / 第三方 Claude DesktopClaudeCursorWindsurf
查看接入方式

LabBook是一个为AI编程代理提供持久化实验跟踪和语义代码搜索的MCP服务器,帮助代理避免重复尝试失败的方法。

一句话选型结论

按资料字段整理

Claude-labbook 属于开发工具类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 14 仓库热度,无公开仓库时显示未标注
工具数 12 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量12暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI编程辅助TypeScript本地部署实验跟踪语义代码搜索MCP服务器代码管理

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
npx claude-labbook

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 12 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Claude-labbook当前 12 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方anthonylee991上游标注的维护方 anthonylee991
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时claude-labbook · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.8 KB
来自项目仓库与上游目录的原文,未做删改

克劳德实验书

AI编码代理的持续实验跟踪和语义代码搜索——永远不要重复失败的方法。

LabBook是一个 MCP服务器 这为Claude Code(和其他兼容MCP的代理)提供了一个持久的记忆,可以记住尝试了什么、成功了什么、失败了什么以及为什么。当上下文窗口压缩或新对话开始时,LabBook会恢复完整的历史记录,以便代理可以从中断的地方继续。


问题

AI编码代理失去上下文。经过长时间的会话后,上下文窗口会压缩,代理会忘记它已经尝试过的内容。它重新尝试相同的失败修复,恢复工作代码,或重新发现相同的死胡同——浪费时间和令牌。

LabBook如何解决这个问题

LabBook将实验历史保存在本地图形数据库(Kuzu)和矢量存储(LanceDB)中。每次代码更改都会记录为 试验 其结果。在修改代码之前,代理会检查已经尝试过的操作。在上下文压缩后,单个 get_briefing 通话可恢复完整画面。


特性

  • 会话跟踪 --将小组相关试验转化为问题解决环节
  • 试验记录 --记录每次代码更改的结果(成功/失败/部分/恢复)和关键经验教训
  • 决策记录 --用基本原理捕捉架构决策,取代过时的决策
  • 环境事实 --在对话中持久化特定于机器的详细信息(命令、路径、端口)
  • 变更前检查 --在修改代码之前,对该组件进行预先试验和主动决策
  • 语义代码搜索 --对代码库进行索引,并按代码搜索 做,而不仅仅是关键字
  • 增量索引 --仅重新索引内容已更改的文件(SHA-256内容哈希)
  • 自动生成简报 — .claude/experiment_log.md 每次写入后都会重新生成,提供人类可读的日志
  • 基于图形的关系 --试验链接到组件,组件映射到代码文件,决策应用于组件,试验链到之前的试验

快速开始

先决条件

  • Node.js 20+

安装```bash

npm install -g claude-labbook


或者直接运行:```bash
npx claude-labbook

或者克隆并从源代码构建:```bash
git clone https://github.com/anthonylee991/claude-labbook.git
cd claude-labbook
npm install
npm run build


### MCP集成

LabBook是一个MCP服务器,旨在供AI代理使用,而不是独立运行。看 MCP设置指南 了解每个编辑器的分步说明。

**克劳德代码(CLI/VS代码):**```bash
claude mcp add labbook -s user -- npx claude-labbook

克劳德桌面/光标/风帆 --添加到MCP配置文件(位置):```json
{
"mcpServers": {
"labbook": {
"command": "npx",
"args": ["claude-labbook"]
}
}
}


看 MCP设置指南 有关Claude Code、Claude Desktop、Cursor、Windsurf和其他MCP兼容编辑器的详细说明。

### 代理说明(重要)

当代理人被告知时,LabBook的效果最好 *当* 调用每个工具。在系统提示中添加说明或 `CLAUDE.md` 文件--请参见 代理说明 作为一个现成的示例。

## 工具

LabBook公开了12个MCP工具:

|工具|说明|
|------|-------------|
| `start_session` |针对问题或功能启动新的实验会话|
| `resolve_session` |将会话标记为已解决、已放弃或已暂停|
| `list_sessions` |列出按状态筛选的会话|
| `log_trial` |记录代码更改的结果(核心工具)|
| `get_trial_chain` |跟随试验链,看看尝试的演变|
| `log_decision` |记录架构或战略决策|
| `log_env_fact` |记录特定于机器或环境的详细信息|
| `get_env_facts` |检索环境事实|
| `get_briefing` |获取所有活动会话、试验和决策的简明摘要|
| `check_before_change` |在修改组件之前,检查之前的试验和决定|
| `scan_codebase` |索引或重新索引项目代码库以进行语义搜索|
| `search_code` |跨索引代码库的语义搜索|

## 运作原理

### 存储

LabBook将数据存储在 `.claude/labbook/` 在您的项目目录中:

- **立体主义** (图形数据库)--会话、试验、组件、决策、环境事实、代码文件以及它们之间的所有关系
- **LanceDB** (向量存储)——试验和代码块语义搜索的嵌入
- **禁食** (`all-MiniLM-L6-v2`)-本地嵌入模型,不需要API调用

### 图形架构```
Session ──CONTAINS──> Trial ──MODIFIES──> Component ──MAPS_TO──> CodeFile
│                    │                     ▲
│                    └──LED_TO──> Trial    │
│                                          │
└── Decision ──APPLIES_TO─────────────────┘
│
└──SUPERSEDES──> Decision

自动生成简报

每次写入操作后,LabBook都会重新生成 .claude/experiment_log.md --总结活动会话、试验的Markdown文件(带有结果图标✅❌⚠️↩️), 决策和环境事实。此文件是人类可读的,可以提交给版本控制。

建筑```

src/
├── db/ # Database layer
│ ├── kuzu.ts # Graph database (sessions, trials, components, decisions)
│ ├── lance.ts # Vector store (trial + code embeddings)
│ └── ids.ts # Auto-increment ID manager
├── scanner/ # Codebase indexing
│ ├── walker.ts # Directory traversal (.gitignore-aware)
│ ├── chunker.ts # Source code chunking (logical boundary splitting)
│ └── languages.ts # File extension → language mapping
├── tools/ # MCP tool implementations
│ ├── sessions.ts # start_session, resolve_session, list_sessions
│ ├── trials.ts # log_trial, get_trial_chain
│ ├── decisions.ts # log_decision
│ ├── env-facts.ts # log_env_fact, get_env_facts
│ ├── briefing.ts # get_briefing
│ ├── check.ts # check_before_change
│ ├── scan.ts # scan_codebase
│ └── search.ts # search_code
├── embeddings.ts # fastembed wrapper (all-MiniLM-L6-v2, 384 dims)
├── formatting.ts # Shared formatting for trials, sessions, decisions
├── summary.ts # Auto-generates .claude/experiment_log.md
├── server.ts # MCP server setup and tool dispatch
└── index.ts # Entry point (stdio transport)
```

文档

文档 描述
MCP设置指南 为所有支持的编辑器逐步配置MCP

贡献

欢迎捐款,但该项目将尽最大努力进行维护。PR可能不会立即审查。看 贡献.md 作为指导方针。

许可证

Apache 2.0——请参阅 许可证 了解详情。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Claude-labbook 怎么安装?

在客户端按下面的安装命令接入:npx claude-labbook。对应的包名是 claude-labbook。装完在客户端配置里引用同一个包或端点。

Claude-labbook 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Claude-labbook 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Claude-labbook 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Claude-labbook 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Windsurf;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Claude-labbook 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 AI编程辅助、代码管理、TypeScript、Claude。具体工具清单以官方文档为准。

Claude-labbook 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Claude-labbook 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。