kitchencoder/second-brain

Second Brain

镜像概述

Second Brain是一个自包含的Docker容器，用于管理个人知识库。它可以挂载您的笔记文件夹，通过语义搜索进行索引，并暴露完整的MCP服务器，使AI客户端（如Claude Code、Claude Desktop、Open WebUI、LM Studio）能够代表您搜索、读取和写入笔记。

镜像版本

如果只需要MCP服务器和核心工具，使用:latest版本；如果需要带Claude Code预配置终端的浏览器IDE，使用:ui版本。

核心功能与特性

• 语义搜索：对挂载的笔记文件夹进行索引，支持智能搜索
• MCP服务器：提供多传输方式（stdio和HTTP）的MCP服务
• 笔记管理工具：包含多种笔记操作工具（搜索、查询、读写、创建等）
• AI客户端集成：兼容Claude系列、Open WebUI、LM Studio等主流AI客户端
• 浏览器IDE（:ui版本）：内置VS Code网页版，方便直接编辑笔记

适用场景

• 个人知识库管理与维护
• AI辅助笔记创作与整理
• 跨设备笔记访问与同步
• 智能笔记检索与关联分析

快速开始

1. 创建笔记目录

bash
# 创建vault目录（或指向现有笔记文件夹）
mkdir -p ~/Documents/brain

2. 运行设置向导

bash
docker run --rm -it \
  -v ~/Documents/brain:/brain \
  kitchencoder/second-brain:latest \
  brain-init

3a. 启动带浏览器IDE的版本

bash
docker run -d --name second-brain --restart unless-stopped \
  -v ~/Documents/brain:/brain \
  -v second-brain-claude:/home/coder/.claude \
  -v second-brain-code-server:/home/coder/.local/share/code-server \
  -v second-brain-zsh:/home/coder/.zsh-data \
  -p 7778:7778 -p 7779:7779 -p 7780:7780 \
  kitchencoder/second-brain:ui
# 打开浏览器访问IDE
open http://localhost:7778

3b. 启动仅MCP服务器的精简版本

bash
docker run -d --name second-brain --restart unless-stopped \
  -v ~/Documents/brain:/brain \
  -v second-brain-claude:/home/coder/.claude \
  -v second-brain-zsh:/home/coder/.zsh-data \
  -p 7779:7779 -p 7780:7780 \
  kitchencoder/second-brain:latest

连接到Claude Code

brain-init会在您的vault中准备Claude Code插件，在主机上安装：

bash
claude plugin marketplace add ~/Documents/brain/.ai
claude plugin install second-brain

这将注册MCP服务器并安装所有技能，无需单独执行claude mcp add。

MCP服务器

同时支持两种传输方式：

通过在vault的.env文件中添加BRAIN_MCP_TRANSPORT=http启用HTTP传输（brain-init默认已设置）。

MCP工具

brain_search · brain_query · brain_read · brain_write · brain_create · brain_edit · brain_related · brain_backlinks · brain_trash · brain_restore · brain_templates

Claude Code技能

全局技能（通过插件安装，可在任何项目中使用）

brain-capture · brain-connect · brain-context · brain-create-effort · brain-distil · brain-effort · brain-project · brain-save · brain-setup · brain-surface · brain-triage

Vault级技能（自动安装，当Claude Code打开vault时加载）

brain-daily · brain-extract · brain-hygiene · brain-rename · brain-reorganise

端口说明

系统要求

• Docker
• 本地嵌入模型（Docker Model Runner、Ollama或LM Studio）或 OpenAI兼容的API端点
• brain-init将引导您完成模型选择

源代码

https://github.com/thekitchencoder/second-brain