第二大脑 MCP 服务器

一个用于智能、安全访问 Obsidian 知识库的只读 MCP 服务器，为 LLM 提供语义搜索、元数据过滤等功能。

功能特性

• 高效数据库存储：基于 SQLite 的索引，适用于大型知识库，支持持久化缓存

• 内存模式选项：为小型知识库或开发环境提供可选的内存索引

• 语义搜索：支持全库全文搜索，具备模糊匹配功能

• 基于标签的过滤：按层级标签搜索（例如 work/puppet, tech/golang）

• 基于路径的过滤：按目录模式过滤（例如 Work/Puppet/**）

• 时间查询：按创建/修改日期过滤笔记

• 元数据过滤：按类型、状态和类别过滤

• 笔记检索：获取特定笔记的完整内容

• 智能摘要：生成笔记集合的摘要

• 最近笔记：快速访问最近修改的笔记

• 归档控制：搜索时可选择是否包含已归档的笔记

• 知识缺口：检测知识库中的孤立维基链接和未解决的问题

• 间隔复习：根据链接重要性对陈旧笔记进行排序，以便定期复习

• 相关笔记：通过共享链接、标签和标题重叠，基于评分发现相关笔记

• 知识库图谱：完整的链接图谱，包含中心节点检测、断链统计和孤立节点分析

• 安全性：路径遍历保护、文件大小限制、输入验证

Related MCP server: Obsidian MCP Server

知识库兼容性

此服务器适用于任何 Markdown 文件目录，而不仅仅是 Obsidian 知识库。它纯粹基于文件系统运行，不依赖于 Obsidian 应用程序。

与 Foam 一起使用

将 --vault-path 指向您的 Foam 工作区根目录。无需更改配置：

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/foam-workspace"

Foam 开箱即用的功能：

• [[wikilinks]] 和 [[target|aliased links]] 在图谱工具中可解析

• YAML Frontmatter 标签（支持内联 [tag1, tag2] 和块列表样式）

• 嵌套标签层级 (work/backend)

• 子文件夹结构 (notes/, journal/, projects/)

• 无 Frontmatter 的笔记将使用安全默认值进行索引

.vscode/ 文件夹会自动从索引中排除。

只读设计

此 MCP 服务器特意设计为只读，以确保您的知识库在 AI 交互期间保持安全。它提供：

• ✅ 搜索和检索笔记

• ✅ 按元数据和路径过滤

• ✅ 生成摘要和统计信息

• ❌ 不创建或编辑笔记

• ❌ 不修改文件

对于写入操作，请考虑使用带有内置安全检查的专用 Obsidian 插件。

安装

配置与安装

一键安装

• VS Code:

• VS Code Insiders:

• Cursor:

手动安装

无需安装！直接使用 npx：

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

本地开发

cd second-brain-mcp
npm install
npm run build
npm link

这使得服务器可以作为 second-brain-mcp 全局使用。

Claude Code & Claude Desktop

Claude Code

使用以下命令添加服务器：

claude mcp add second-brain -- npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Claude Desktop

添加到您的 Claude Desktop 配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/path/to/your/vault"
      ]
    }
  }
}

有关知识库结构、CLI 参数和配置示例，请参阅 docs/configuration.md。

有关完整的 MCP API 参考和使用示例，请参阅 docs/api.md。

与 Claude Code 一起使用

添加到您的 MCP 配置文件中。

单个知识库配置

macOS/Linux: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json Windows: 编辑 %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/ioanniskarasavvaidis/Documents/Obsidian Vault"
      ]
    }
  }
}

多个知识库配置

您可以配置多个知识库实例：

{
  "mcpServers": {
    "second-brain-personal": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Personal Vault"
      ]
    },
    "second-brain-work": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Work Vault"
      ]
    }
  }
}

本地开发设置

如果您正在使用 npm link 进行本地开发：

{
  "mcpServers": {
    "second-brain": {
      "command": "second-brain-mcp",
      "args": ["--vault-path", "/path/to/your/vault"]
    }
  }
}

有关更多查询示例，请参阅 docs/examples.md。

文档

请参阅 docs/README.md 获取：

• API 参考

• 配置与 CLI 选项

• 查询示例

• 开发与存储架构

• 贡献指南

• 依赖项

• 架构与数据库模式

• 安全性与搜索

• 查询示例

• 开发

• 贡献

• 依赖项

• 许可证

快速开始

使用 npx 立即运行服务器（无需安装）：

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

或者添加到 Claude Code/Claude Desktop（见下文“配置与安装”）。

故障排除与常见问题

有关常见问题和解决方案，请参阅 docs/configuration.md。

有关搜索权重和评分的详细信息，请参阅 docs/search.md。

有关安全功能和保护的详细信息，请参阅 docs/security.md。

有关开发工作流和存储的详细信息，请参阅 docs/development.md。

有关贡献指南，请参阅 docs/contributing.md。

存储架构

服务器默认使用 SQLite 数据库存储，以实现高效索引和持久化缓存：

• 数据库模式（默认）：将索引后的笔记存储在知识库内的 .second-brain-mcp/notes.db 中

  • 持久化索引（服务器重启后依然存在）

  • 对大型知识库（1000+ 笔记）高效

  • 使用 SQLite FTS5 进行全文搜索

  • 内存占用更低

• 内存模式（可选）：使用 --use-memory 标志进行内存存储

  • 对小型知识库（<100 笔记）更快

  • 无磁盘 I/O 开销

  • 适用于开发和测试

  • 使用 Fuse.js 进行模糊搜索

有关架构图，请参阅 docs/architecture.md。 有关数据库模式，请参阅 docs/database-schema.md。

架构

• src/index.ts: 带有工具处理程序的 MCP 服务器实现

• src/vault.ts: 知识库索引编排和安全控制

• src/storage.ts: 存储接口抽象

• src/database-storage.ts: 基于 SQLite 的存储实现

• src/memory-storage.ts: 使用 Fuse.js 的内存存储实现

• src/storage-factory.ts: 用于模式选择的存储工厂模式

• src/config.ts: 带有默认值的配置管理

• src/types.ts: TypeScript 类型定义和验证工具

• src/__tests__/: 关键功能的单元测试

有关生产和开发依赖项的完整列表，请参阅 docs/dependencies.md。

支持

如果 second-brain-mcp 节省了您的时间，请考虑在 GitHub 上赞助我 或 请我喝杯咖啡。

许可证

MIT