MB

mi4uu/brain.md

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

34 stars 4 forks 质量 80 趋势 32AGPL-3.0

本地优先的标记笔记,配备一流的MCP服务器。16个工具+2个资源,适用于Claude代码、Claude桌面版、光标及任何MCP代理。

概览

LLM的智能程度取决于你赋予它们的上下文。它能将你的笔记转化为那个上下文——无需将其拖入别人的云端,无需锁定专有格式,也不必要求你自己挖掘向量数据库。 - 一个打磨得精致的,采用完整的Obsidian风格方言(wikilinks、嵌入、呼号、数学、美人鱼、高亮、任务、前置、别名),- 每个vault嵌入的向量存储(纯JS,单一二进制),默认本地bge-small-en-v1.5嵌入器,通过捆绑的WASM ONNX运行——切换到、或任何其他带有/v1/embeddings端点的设备,只需一个开关,- 一个(可流式HTTP)安装在同一端口上,这样Claude Desktop(或任何MCP客户端)可以安全地读取、搜索和写入你的笔记——对于代理表面,- 可选,适用于整个vault。 所有程序都在你的电脑上运行。保险库是一个普通的.md文件文件夹,你可以随时在任何编辑器中打开。 脑子。

概述(AI 翻译)

为你和你的人工智能代理打造一个本地优先的第二大脑。

你得到的是什么

📝   兼容Obsidian的Markdown 维基链接、嵌入、注解、数学、美人鱼、任务、前言、别名。打开你现有的Obsidian保险库——它就能正常工作。
⚡   实时编辑器+预览 CodeMirror 6,带光标锚定滚动同步、自动保存、即时提示、命令面板、快速切换。
🔍   内置语义搜索 每个vault内嵌向量存储(纯JS,无外部数据库)。笔记在每个存档上都被分块、嵌入和索引。
🤖   可插拔嵌入器 默认:bge-small-en-v1.5通过捆绑的WASM ONNX本地运行——在预构建的单一二进制中运行,零原生DEPS。或者指向Ollama、LM Studio、OpenAI——任何带有/v1/embeddings的软件。
🛰️   MCP 服务器(可流式 HTTP) 17 个工具 + 2 个资源挂载在同一端口上。Claude Desktop、Claude Code、Cursor 以及任何符合 MCP 的代理都可以读取、搜索、查询和写入你的笔记。
🔒   每个文件夹的代理权限 右键点击一个文件夹→设置为 {read, write} 作为 MCP 表面。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

📝   Obsidian-compatible markdown Wikilinks, embeds, callouts, math, mermaid, tasks, frontmatter, aliases. Open your existing Obsidian vault — it just works.
⚡   Live editor + preview CodeMirror 6 with cursor-anchored scroll sync, autosave, instant tooltips, command palette, quick switcher.
🔍   Semantic search built in Per-vault embedded vector store (pure JS, no external DB). Notes are chunked, embedded and indexed on every save.
🤖   Pluggable embedders Default: bge-small-en-v1.5 running locally via bundled WASM ONNX — works in the prebuilt single binary, zero native deps. Or point at Ollama, LM Studio, OpenAI — anything with /v1/embeddings.
🛰️   MCP server (streamable HTTP) 17 tools + 2 resources mounted on the same port. Claude Desktop, Claude Code, Cursor and any MCP-compliant agent can read, search, query and write your notes.
🔒   Per-folder agent permissions Right-click a folder → set {read, write} for the MCP surface. Keep Journal/Private/ out of agent reach without locking down the vault.
🔑   Optional password auth argon2id, bearer tokens, 24-hour TTL — gates both HTTP API and MCP. Off by default, on with one click.
📜   Git autocommit Every save lands in git. Full history, diff, restore, manual checkpoints. The vault is a real git repo on disk.
🌍   No vendor lock-in Your vault is a folder of .md files. Open it in VSCode, Obsidian, cat, anything. brain.md is just one more way to view and query it.
💸   Zero API keys required Out of the box it runs fully offline. Cloud embedders are an opt-in, not a default.

Why brain.md

LLMs are only as smart as the context you give them. brain.md turns your notes into that context — without dragging them into someone else’s cloud, without locking them inside a proprietary format, and without asking you to plumb a vector database yourself.

You write markdown. brain.md gives you:

在 GitHub 查看完整 README

安装

npx mcp-remote http://localhost:3000/mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "brain.md": { "type": "streamable-http", "url": "http://localhost:3000/mcp" } } }