The Obsidian Brain MCP

Obsidian Brain MCP

Bridge the gap between your AI conversations and your second brain

Stop losing insights to the void of AI chat history. Start building a knowledge graph that grows with every conversation.

______________________________________________________________________

问题

你去过那里。与你的人工智能助手一起进行数小时的编码会议或研究兔子洞。发现。问题解决了。概念终于点击了。

然后关闭聊天。

跑了。

所有这些见解、解释和突破都分散在保存不佳的claude代码会话或chatgpt聊天历史中。与此同时，你的黑曜石金库正在等待，准备连接想法，但与你最佳思维的实际发生地完全脱节。

解决方案

黑曜石脑MCP 在你的人工智能助手和黑曜石金库之间建立一座活生生的桥梁。你的法学硕士不仅 *回应*它 *记得*, *组织*，以及 *连接*.

AI Conversation    Obsidian Brain MCP    Your Vault

现在，您的助手可以：

• 捕捉洞察 当你发现它们时，直接进入你的保险库
• 建立联系 通过将新笔记与现有知识联系起来
• 搜索你的头脑 找到你忘记的相关笔记
• 理解你的图表 并帮助你看到思维中的模式
• 匹配你的风格 从实际写作中学习

______________________________________________________________________

在行动中看到它

Creating notes, building connections, and searching your vault--all through natural conversation.

______________________________________________________________________

用例

Learning & Research

*“解释React服务器组件的工作原理”*

当你的人工智能解释这个概念时，让它将关键见解直接保存到你的保险库中。它会创建一个注释，并将其链接到您现有的 [[React]] 和 [[Frontend Architecture]] 注释并标记它 #learning #react #server-components.

下周，当你调试RSC问题时，你的人工智能可以搜索你的保险库，并提醒你一起构建的心理模型。

Coding Sessions

*“帮助我调试此身份验证流”*

经过2个小时的调试，你终于破解了它。与其失去来之不易的知识，不如让你的人工智能记录解决方案。它在下面创建一个注释 Development/Debugging 与：

• 你遇到的症状
• 根本原因
• 修复
• 相关笔记的链接，如 [[Auth Middleware]] 和 [[JWT Tokens]]

未来你会感谢现在的你。

Writing & Content Creation

*“让我们为我关于人工智能生产力的博客文章集思广益”*

随着想法的流动，你的人工智能会在草稿中捕捉到它们。当你以一个好的角度着陆时，它会将内容移动到你的 Writing/Drafts 文件夹，添加相关标签，并链接到您的研究笔记 [[AI Tools]] 和 [[Personal Productivity]].

你的金库成为你写作伙伴的记忆。

Meeting Notes & Action Items

*“将今天的站立笔记添加到我的每日笔记中”*

你的人工智能会在今天的每日笔记中添加一个带时间戳的条目，其中包含讨论点、做出的决定和行动项——所有这些都被正确标记并链接到相关的项目笔记。

## 10:30 - Standup
- Discussed [[Project Alpha]] timeline
- Decision: Push launch to Q2 #decision
- Action: Review PR #142 by EOD #todo

Personal Knowledge Management

*“我对分布式系统了解多少？”*

你的AI搜索你的金库，找到23个相关的笔记 Learning/, Projects/，以及 Books/，并综合了您的知识概况。它确定了差距，并提出了进一步探索的领域。

你分散的笔记变成了一个可查询的知识库。

Book & Article Notes

*“我刚刚读完《系统思维》——帮助我捕捉关键思想”*

当你讨论这本书时，你的人工智能会以你喜欢的格式创建结构化的文献笔记，将关键概念提取到原子笔记中，并将它们与相关的反向链接编织到你现有的知识图中。

你读的每一本书都会强化你的第二大脑。

______________________________________________________________________

特性

______________________________________________________________________

先决条件

1. 黑曜石1.12.4+ 启用CLI后：

- 打开 黑曜石设置>常规>命令行界面 - 启用CLI切换 - 这 obsidian 命令必须在PATH上 - 或者，设置 OBSIDIAN_CLI_PATH 环境变量的完整路径 obsidian 二进制

1. 紫外线 包管理器： 安装uv

安装

添加到MCP客户端配置中：

Cursor

添加 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （项目）：

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
    }
  }
}

看 光标MCP文档 了解更多详情。

Claude Desktop / Claude Code

配置位置：

• Linux： ~/.config/claude-desktop/claude_desktop_config.json 或 ~/.claude.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP",
        "obsidian-brain"
      ]
    }
  }
}

看 克劳德代码MCP文档 了解更多详情。

OpenAI Codex CLI

使用CLI添加服务器：

codex mcp add obsidian-brain \
  -- uvx --from git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP obsidian-brain

或手动编辑 ~/.codex/config.toml:

[mcp_servers.obsidian-brain]
command = "uvx"
args = ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]

看 食品法典委员会MCP文件 了解更多详情。

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
    }
  }
}

看 Windsurf MCP文件 了解更多详情。

VS Code (GitHub Copilot)

添加 .vscode/mcp.json （项目）或全局设置：

{
  "servers": {
    "obsidian-brain": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
    }
  }
}

看 VS代码MCP文档 了解更多详情。

Zed

添加 ~/.config/zed/settings.json （Linux）或 ~/Library/Application Support/Zed/settings.json （macOS）：

{
  "context_servers": {
    "obsidian-brain": {
      "command": {
        "path": "uvx",
        "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
      }
    }
  }
}

看 Zed MCP文件 了解更多详情。

OpenCode

添加 opencode.json 在您的项目中：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "obsidian-brain": {
      "type": "local",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"],
      "enabled": true
    }
  }
}

看 OpenCode MCP文档 了解更多详情。

Direct CLI Usage

# Run directly (for testing)
uvx --from git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP obsidian-brain

# Or install as a tool
uv tool install git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP
obsidian-brain

______________________________________________________________________

配置

服务器自动检测 obsidian PATH上的CLI二进制文件。集 OBSIDIAN_CLI_PATH 仅当二进制文件安装在非标准位置时。

______________________________________________________________________

可用工具

保险库操作

链接操作

标签操作

搜索操作

每日笔记

知识与记忆

______________________________________________________________________

发展

# Clone the repository
git clone https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP.git
cd The-Obsidian-Brain-MCP

# Install dependencies
uv sync --dev

# Run tests
uv run pytest

# Lint
uv run ruff check .

______________________________________________________________________

贡献

欢迎投稿！无论是bug修复、新功能还是文档改进。

______________________________________________________________________

许可证

麻省理工学院 --用它创造一些令人惊叹的东西。

______________________________________________________________________

Stop losing your best ideas to chat history.

Let your AI and your vault think together.