MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Search an Obsidian vault by tag, term and wikilink graph. Read-only, deterministic, no embeddings.
教 AI 做这类工作的 Skill,可与本项一起使用
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 0/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 7/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 0/8 | 上次检查时云端端点有响应 |
| 使用分 | 7/100 |
质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
选择你使用的 AI 应用,然后复制设置。
通过 3/3 项检查 · 在你的电脑上运行
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
ChatGPT 暂时无法连接 Obsidian Notes
开发者尚未在 MCP 注册表中填写安装方式
Claude Code 暂时无法连接 Obsidian Notes
开发者尚未在 MCP 注册表中填写安装方式
Cursor 暂时无法连接 Obsidian Notes
开发者尚未在 MCP 注册表中填写安装方式
VS Code 暂时无法连接 Obsidian Notes
开发者尚未在 MCP 注册表中填写安装方式
OBSIDIAN_VAULT env说明仍为英文原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日
注册名称已通过 GitHub 账户 moreno-omar 验证,该账户拥有此仓库
代码最后更新于38天前
使用 Apache-2.0
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/moreno-omar-mcp-obsidian)提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于38天前,最新版本(0.1.0)于38天前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Rust。
同一分类中有:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| 本项 Obsidian Notes | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| 运行位置 | 需要安装在电脑上 | 在云端运行,无需安装 | 需要安装在电脑上 | 在云端运行,无需安装 | 在云端运行,无需安装 | 需要安装在电脑上 |
| 需要密钥 | 否 | 否 | 否 | 是 | 否 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 否 | 是 | 否 |
| 基础检查 | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| 许可证 | Apache-2.0 | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Download the bundle for your Mac or PC from the latest release, open it, point it at your vault.
The bundles are unsigned. That is normal for .mcpb: mcpb pack does not sign by default, and signing is a separate opt-in step with a certificate of your own. If you run mcpb info on the download you will see WARNING: Not signed — ignore it. It has no effect on installing or using the extension.
Signing is not enabled yet because the upstream tooling is currently broken: mcpb sign produces a bundle that Claude Desktop refuses to install (#278), and mcpb verify reports signed bundles as unsigned (#276). It will be added once those are fixed.
cargo install mcp-obsidian
Then point it at a vault:
mcp-obsidian --vault ~/vault index # print the index, no model involved
mcp-obsidian --vault ~/vault serve # stdio MCP server for a desktop host mcp-obsidian --vault ~/vault serve --http # Streamable HTTP on 127.0.0.1:8000/mcp
Published on crates.io: https://crates.io/crates/mcp-obsidian
cargo install mcp-obsidian
mcp-obsidian --vault ~/vault serve
The crate is dual-licensed and its README carries the registry ownership token, so it can also be listed in the Official MCP Registry and shipped as an MCPB bundle without further changes.
The line below is the package-ownership token the registry verifies against this crate's README. It must stay visible in plain text — crates.io strips HTML comments — and must match the name in server.json.
mcp-name: io.github.moreno-omar/mcp-obsidian
Everything below runs locally on one desktop — an NVIDIA RTX 4060 Ti (16 GB) serving `gemma4:e4b` through Ollama, with the vault read from disk. No API keys, no cloud calls, no data leaving the machine: the only network traffic is localhost:11434.
ask — one prompt, answered from the vaultchat — the same loop, interactive| Preview | What it shows | | :- | :- | | | index: every note with its link count and tags, rendered as a table. | | | chat: the welcome panel, the tool trace and a markdown-rendered answer. | | | The vault material behind the Phase 3 exit criterion, python/python_oneliners/list comprehensions.md. |
mcp-obsidian prints, it does not paint. There is no alternate screen, no event loop and no per-frame redraw: colours and layout are computed once per answer with richrs, written to stdout, and the process exits. Measured on the machine above:
| step | measured | | :- | :- | | index a 490-note vault (once, at startup) | ~60 ms | | vault query (search, index, MCP tool call) | ~60 ms, no model involved | | full ask round trip (pre-search + tool rounds + answer) | seconds — the local model is the only slow part |
A full-fledged TUI pays for a layout pass and a terminal repaint on every frame, and a streaming chat UI adds one per token on top. Here the terminal does one write per answer and the entire budget goes to the model, so retrieval feels instant and the answer lands as soon as the GPU is done. It also keeps the output an ordinary Unix stream: ask "…" > answer.md, | grep, NO_COLOR=1 and FORCE_COLOR=1 all behave the way you expect.
Phase 1 complete (2026-09-28): the CLI can talk to Ollama and the tool set is served over MCP.
Phase 2 complete (2026-10-01): the retrieval and Ollama layers are split into small modules (src/vault/, src/ollama_client/) behind a library target, with 32 tests pinning the behaviour.
Phase 3 complete (2026-10-09): ask is grounded in the vault — an imperative tool protocol plus a deterministic pre-search, so a model that never calls a tool still gets the relevant notes. Output is rendered with richrs in a Tokyo Night theme for ask, chat, doctor, index, search and serve (colours auto-off when piping).
Phase 4 in progress (2026-10-09): published to crates.io as `mcp-obsidian` v0.1.0 (cargo install mcp-obsidian). The binary is dual-licensed and carries registry metadata; server.json validates against the Official MCP Registry; scripts/build_mcpb.sh produces a schema-valid MCPB bundle for Smithery; and serve --http adds a Streamable-HTTP transport for remote hosts. See DEPLOYMENT.md for hosting it behind a public HTTPS URL and listing it on Smithery and the ChatGPT directory, and logs/2026-10-09_mcp_obsidian_phase4_publishing.md for the detail.
See SUMMARY.md for how it works and why, ARCHITECTURE.md for how to read the code and where to change it, logs/MCP_notes.md for the implementation comparison, and TASKS.md for what is done and what is next.
cargo build --release
./target/release/mcp-obsidian --vault ~/vault index ./target/release/mcp-obsidian --vault ~/vault search tag project --match-all ./target/release/mcp-obsidian --vault ~/vault search term "token budget" ./target/release/mcp-obsidian --vault ~/vault search links index --depth 2 ./target/release/mcp-obsidian --vault ~/vault search note projects/alpha
./target/release/mcp-obsidian --vault ~/vault doctor ./target/release/mcp-obsidian --vault ~/vault ask "what do my notes say about token budgets?" --trace ./target/release/mcp-obsidian --vault ~/vault ask "…" --no-prefetch # no pre-search, tools only ./target/release/mcp-obsidian --vault ~/vault chat
./target/release/mcp-obsidian --vault ~/vault serve ./target/release/mcp-obsidian --vault ~/vault serve -vv # log each tool call to stderr
./target/release/mcp-obsidian --vault ~/vault serve --http # 127.0.0.1:8000/mcp ./target/release/mcp-obsidian --vault ~/vault serve --http 0.0.0.0:8000 ./target/release/mcp-obsidian --vault ~/vault serve --http 0.0.0.0:8000 \ --allow-host vault.example.com # accept that Host header
serve speaks stdio by default so stdout stays the JSON-RPC channel; --http switches to Streamable HTTP on /mcp instead. HTTP mode has no authentication — it binds loopback by default and rmcp rejects non-loopback Host headers, so put a reverse proxy in front of it before exposing it publicly. See PUBLISHING.md for what the ChatGPT/plugin directory additionally requires.
A ready-to-edit host configuration is in claude_desktop_config.example.json. Environment variables OBSIDIAN_VAULT, OLLAMA_URL, OLLAMA_MODEL and RUST_LOG override the defaults; --api native switches from /v1/chat/completions to /api/chat. Colour is emitted only to a terminal: NO_COLOR=1 disables it, FORCE_COLOR=1 forces it when piping.
Answers are word-wrapped to the terminal width, with continuation lines aligned under the text instead of under the bullet. Redirected output is deliberately not wrapped, so ask "…" > answer.md keeps the model's own line structure.
A sample vault lives in samples/vault/ for trying the commands above.
cargo test # vault + ollama client; no model needed
cargo test -- --ignored live_client # needs a running Ollama with the model pulled
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.