Obsidian MCP Sb

第二大脑MCP服务器

一个只读的MCP服务器，用于智能、安全地访问您的黑曜石保险库，为LLM提供语义搜索、元数据过滤等功能。

特性

• 高效的数据库存储：基于SQLite的大型Vault索引，具有持久缓存功能
• 内存模式选项：用于小型Vault或开发的可选内存索引
• 语义搜索：通过模糊匹配在所有笔记中进行全文搜索
• 基于标签的过滤：通过分层标签搜索（例如。， work/puppet, tech/golang)
• 基于路径的过滤：按目录模式过滤（例如。， Work/Puppet/**)
• 时态查询：按创建/修改日期过滤笔记
• 元数据筛选：按类型、状态和类别筛选
• 笔记检索：获取特定笔记的完整内容
• 智能摘要：生成笔记收集摘要
• 最近的笔记：快速访问最近修改的笔记
• 档案管理：可选择在搜索中包含存档笔记
• 知识缺口：检测整个保管库中孤立的维基链接和未解决的问题
• 空格评论：按链接重要性对表面陈旧的笔记进行定期审查
• 相关说明：通过共享链接、标签和标题重叠，基于分数发现相关笔记
• 保险库图形：具有集线器检测、断开链接统计和孤立分析的完整链接图
• 安全：路径遍历保护、文件大小限制、输入验证

保险库兼容性

此服务器与 Markdown文件的任何目录 --不仅仅是黑曜石拱顶。它完全在文件系统上运行，不依赖于Obsidian应用程序。

与泡沫一起使用

点 --vault-path 在您的Foam工作空间根。无需更改配置：

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

泡沫具有开箱即用的特点：

• [[wikilinks]] 和 [[target|aliased links]] 在图形工具中解决
• YAML frontmatter标签（均为内联 [tag1, tag2] 以及阻止列表样式）
• 嵌套标记层次结构(work/backend)
• 子文件夹结构(notes/, journal/, projects/)
• 没有使用安全默认值索引的前体注释

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

只读设计

此MCP服务器是故意的 只读 以确保您的保险库在人工智能交互期间保持安全。它提供：

• ✅ 搜索和检索笔记
• ✅ 按元数据和路径筛选
• ✅ 生成摘要和统计数据
• ❌ 无笔记创建或编辑
• ❌ 无文件修改

对于写操作，考虑使用内置安全检查的专用黑曜石插件。

安装

配置和安装

一键安装

• VS代码：


• VS代码内幕人士：


• 光标：


手动安装

无需安装！直接与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 mcp add second-brain -- npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

克劳德桌面版

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

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json\ 窗户： %APPDATA%/Claude/claude_desktop_config.json

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

看 docs/configuration.md 有关vault结构、CLI参数和配置示例。

看 docs/api.md 以获取完整的MCP API参考和使用示例。

使用Claude代码

添加到MCP配置文件中。

单保险库配置

macOS/Linux： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： 编辑 %APPDATA%\Claude\claude_desktop_config.json

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

多保险库配置

您可以配置多个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：Vault索引编排和安全控制
• 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 获取生产和开发依赖关系的完整列表。

______________________________________________________________________

支持

如果第二大脑mcp为您节省时间，请考虑 或 请我喝杯咖啡.

许可证

麻省理工学院