Obsidian Second Brain

克劳德的黑曜石第二大脑

一个由git支持的黑曜石库，Claude通过MCP进行读写操作，创建了一个持久的、相互连接的知识图，随着你的工作而增长。

运作原理

Claude Code ──► MCP Server ──► Obsidian REST API ──► Vault (markdown + wikilinks)

• 会话开始： 克劳德拉取最新笔记，搜索你当前工作的背景
• 工作期间： Claude将发现（API关系、架构决策、操作异常）添加到相关注释中
• 会话结束： 说“结束”，克劳德就会创建一个会话摘要，将所有涉及的内容联系起来

拱顶结构

services/           One note per repo/service, with tech stack, endpoints, relationships
architecture/       Cross-cutting design decisions and ADRs
operations/         Deployment patterns, infra, runbooks, environment setup
relationships/      Service maps connecting everything
sessions//    Per-user session summaries (episodic memory)
templates/          Note templates for consistency

笔记使用 YAML 前言 用于结构化过滤和 \[\[维基链接\]\] 用于图形连接。在Obsidian中打开vault以查看图形视图。

设置（5分钟）

先决条件

• 黑曜石 安装
• 18+（适用于MCP服务器）
• 克劳德代码 命令行界面

步骤

1. 克隆此仓库 你想要你的保险库在哪里：

   git clone https://github.com/farminglvl99osrs/obsidian-second-brain.git ~/Documents/my-vault
   cd ~/Documents/my-vault

1. 作为黑曜石拱顶打开：

- 打开Obsidian>“将文件夹作为vault打开”>选择克隆的目录

1. 安装REST API插件：

- 设置>社区插件>启用社区插件 - 浏览>搜索“本地REST API”>安装（Adam Coddington）>启用 - 从插件设置中复制API密钥

1. 运行安装脚本：

   ./setup.sh

这将：

- 验证先决条件（Node.js、npx） - 在中配置Obsidian MCP服务器 ~/.claude/mcp.json - 创建您的个人会话目录

1. 添加行为规则 到您的Claude自动内存中（安装脚本会打印出确切的文本）

1. 重新启动Claude代码 加载MCP服务器

团队使用情况

这个保险库是为通过git进行团队共享而设计的：

• 每个人克隆仓库，并将其作为自己的黑曜石金库打开
• 每个人都跑 ./setup.sh 配置其本地MCP连接
• 会话目录是按用户命名的(sessions/dylan/, sessions/alex/)
• 架构决策可以通过公关审查
• .obsidian/ 被忽略（个人设置保持在本地）

注释模板

服务说明(templates/service.md)

用于记录存储库和服务：概述、技术栈、端点、关系、操作说明。Frontmatter包括 type, status, repo, owner, tags, last_updated.

会话摘要(templates/session.md)

克劳德在“包装”时自动生成。捕捉上下文、学习、决策和开放式问题，并链接到服务和工单。

架构决策(templates/architecture-decision.md)

对于跨领域决策：决策、背景（为什么）和后果（对服务的影响）。

克劳德的行为准则

这些会进入你的克劳德汽车记忆(MEMORY.md):

## Obsidian Second Brain (Vault: 
)
- **Start:** Run `git pull` in the vault, then use Obsidian `search` tool for context.
- **During:** When discovering new API relationships, architecture decisions, or
  operational quirks, use `append_content` or `patch_content` to update the relevant
  note. Always update `last_updated` frontmatter.
- **End:** When I say "wrap it up", create a session summary in
  `sessions//YYYY-MM-DD-.md`, then git add, commit, and push.

安全

• Obsidian REST API绑定到 127.0.0.1 仅限（本地主机）
• 承载令牌存储在环境变量中，从未提交
• 无外部网络访问
• .obsidian/ gitignored（个人设置保持在本地）