Loschke AI Brainsidian MCP

Brainsidian MCP（注：此处“Brainsidian MCP”可能是一个特定公司或项目的名称，直接翻译为中文可能无法准确传达其原意，因此保持原样，但若需解释性翻译，可根据上下文调整，如“Brainsidian的MCP项目/方案”等）

一个基于（某技术或框架，原文未指明）的用于Obsidian知识库管理的智能模型上下文协议（MCP）服务器 bitbonsai/mcp-obsidian（可译为）：bitbonsai的MCP（模组兼容计划）- Obsidian（石墨烯/黑曜石，根据上下文可能指特定模组或资源包）


🎯 愿景

Brainsidian将Claude Desktop与您的本地Obsidian知识库相连接，通过人工智能实现智能知识管理。您可以使用自然语言创建、阅读、搜索和组织笔记，同时保持知识库的结构和规范不变。

✨ 特点/功能

当前（第一阶段）✅

• 完整的CRUD操作读取、写入、更新、删除笔记，支持前置信息
• 智能搜索内容和前言搜索支持正则表达式
• 标签管理在你的笔记中添加、删除和列出标签
• 批量操作高效阅读多条笔记
• 路径安全系统文件的自动过滤与验证
• 优化后的代币（或标记）40-60%更小的API响应，以提升性能

当前（第二阶段）✅

• 模板支持从4个可定制模板创建笔记

- 快速笔记（80%的笔记） - 知识笔记（知识/概念） - 项目（多个项目/客户） - 内容（博客/视频/播客）

• 自动占位符替换： {{date}}， {{title}}， {{tags}}
• 智能文件名清理自动处理无效字符
• 标签验证智能拼写检查与建议（例如，ai-koding → ai-coding）

当前（第三阶段）✅

• 反向链接发现查找所有链接到目标笔记的笔记
• 链接建议基于关键词分析的AI智能推荐（德语+英语）
• Vault 健康检查全面分析，结合数据统计与问题检测

未来改进计划 📅

• 图形可视化
• 基于嵌入的高级语义搜索
• 多保险库支持

📦 安装

先决条件

• Node.js 18.0.0 或更高版本
• 一个Obsidian资料库（本地目录，包含 .md 文件)
• Claude Desktop（可译为“Claude桌面版”或保持原样，具体取决于上下文是否需要更具体的翻译）

设置

1. 克隆仓库：

git clone https://github.com/YOUR_USERNAME/brainsidian-mcp.git
cd brainsidian-mcp

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

1. 配置Claude桌面版：

编辑 claude_desktop_config.json：

• Windows： %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "brainsidian": {
      "command": "node",
      "args": [
        "/path/to/brainsidian-mcp/dist/server.js",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

1. 重启Claude桌面版

🚀 使用方法

可用工具

1. 阅读笔记 - 读取带有解析后的前置元数据的笔记内容
2. 写笔记 - 在笔记中写入/追加/添加内容到开头
3. 列出目录 - 列出保险库中的文件和文件夹
4. 删除笔记 - 安全删除笔记（需确认）
5. 移动笔记 - 移动或重命名笔记
6. 搜索笔记 - 在整个存储库中进行全文搜索
7. 读取多个笔记 - 批量读取最多10条笔记
8. 获取前文内容（或前置信息） - 仅提取前置内容元数据
9. 更新前言/前文内容 - 更新笔记元数据
10. 管理标签 - 添加、删除或列出标签
11. 获取笔记信息 - 获取文件元数据而不获取内容
12. 根据模板创建笔记 ✨ - 使用带有自动占位符的模板创建笔记
13. 查找反向链接 ✨ - 发现所有链接到目标笔记的笔记
14. vault健康检查 ✨ - 使用统计数据和问题检测分析保险库健康状况
15. 建议链接 ✨ - 基于内容相似性的AI驱动链接推荐

示例对话

基本操作：

• “列出我Obsidian知识库中的文件”
• “看看我写的名为‘project-ideas.md’的笔记”
• “搜索有关机器学习的笔记”

内容创作：

• “创建一个带有今天日期的新笔记”
• “将这个任务添加到我的日常笔记中”
• “在我的任务备注中添加‘项目’和‘紧急’两个标签”

基于模板的创建： ✨（闪亮的星星符号，常用于表示兴奋、喜悦或强调）

• “创建一个标题为‘会议记录’的快速笔记，并添加标签ai-strategy”
• “在‘03-Fachwissen’文件夹中创建一个关于‘MCP架构’的知识笔记”
• “为‘博客：AI模板’创建内容说明，并添加标签blog、ai-tools”

知识管理：

• “显示所有标记为‘ai-coding’的笔记”
• “查找项目文件夹中的所有笔记”
• “我的研究笔记的前言部分里有什么内容？”

知识图谱： ✨（闪闪发光的符号，常用于表达喜悦、兴奋或强调）

• “查找所有链接到‘思维链’的笔记”
• “给我展示一下我的MCP架构笔记的反向链接”
• “哪些笔记引用了我的提示工程指南？”

情报与分析： ✨（闪亮的星星或光芒）

• “对我的保险库进行健康检查”
• “为我的提示工程指南提供相关笔记建议”
• “我应该从这份新概念笔记中链接到哪些笔记？”

🏗️ 项目结构

brainsidian-mcp/
├── src/
│   ├── filesystem.ts      # File operations with path validation
│   ├── frontmatter.ts     # YAML frontmatter handling
│   ├── pathfilter.ts      # Security and file filtering
│   ├── search.ts          # Search functionality
│   └── types.ts           # TypeScript definitions
├── dist/                  # Compiled JavaScript
├── docs/
│   └── prd-brainsidian.md # Product Requirements Document
├── config.json            # Vault and template configuration
├── server.ts              # MCP server entry point
└── package.json

📋 配置

创建一个 config.json 在项目根目录中：

{
  "vaultPath": "/path/to/vault",
  "templatesPath": "_Templates",
  "templates": {
    "quick-note": "Template - Quick Note.md",
    "wissensnotiz": "Template - Wissensnotiz.md",
    "projekt": "Template - Projekt.md",
    "content": "Template - Content.md"
  },
  "defaultTags": {
    "wissensbereiche": ["ai-essentials", "ai-coding", ...],
    "outputTypen": ["blog", "saas", "vortrag", ...],
    "status": ["idee", "in-arbeit", "fertig", ...]
  }
}

🔒 安全

Brainsidian实施了多项安全措施：

• 路径遍历保护所有路径均针对保险库边界进行了验证
• 符号链接安全性已检查解析路径的安全性
• 文件过滤系统文件（.obsidian， .git) 自动排除
• 内容验证在写入前验证YAML前置元数据
• 最小特权原则服务器仅访问指定的保险库目录

🧪 开发

运行测试

npm test

开发模式

npm run dev "/path/to/your/vault"

建筑；建造

npm run build

📖 路线图

第一阶段：核心运营 ✅

• \[x\] 读取/写入/更新/删除笔记
• \[x\] 搜索和目录列表
• \[x\] 标签管理
• \[x\] 批处理操作

第二阶段：模板与验证 ✅

• \[x\] 模板加载与应用
• \[x\] 占位符替换（{{日期}}，{{标题}}，{{标签}}）
• \[x\] 使用4种模板智能创建笔记
• \[x\] 文件名净化（或：文件名清理）
• \[x\] 标签验证并提供拼写建议

第三阶段：智能特性 ✅

• \[x\] 反向链接发现（find_backlinks）
• \[x\] 链接建议（基于关键词的建议链接）
• \[x\] Vault 健康检查（vault_health_check）

🤝 贡献（或：参与贡献）

欢迎贡献！请阅读产品需求文档（PRD） docs/prd-brainsidian.md 关于详细要求和架构。

📄 许可证

MIT 许可证 - 详情请参见 LICENSE 文件

🙏 致谢

建立在……之上 bitbonsai/mcp-obsidian 翻译为中文可以是：“微型盆景/MCP-黑曜石” 或者根据具体语境，也可以意译为“微型盆景项目/黑曜石MCP（可能是指某种特定的微型盆景制作或管理系统）”。不过，由于“MCP-obsidian”可能是一个特定项目或系统的名称，没有上下文很难确定其确切含义，所以这里给出了一个较为通用的翻译 - 一个轻量级的MCP服务器，用于访问Obsidian知识库。

特别感谢：

• Anthropic公司的MCP团队
• 黑曜石社区
• 所有贡献者

📞 支持

• 问题:
• PRD（可能指“革命制度党”或根据上下文有其他具体含义）见 docs/prd-brainsidian.md 以获取详细规格
• 设置见 SETUP.md 用于详细的设置说明
• 更新日志见 CHANGELOG.md 用于版本历史

______________________________________________________________________

为Obsidian社区倾心打造