Obsidian笔记管理服务

一个轻量级的MCP风格JSON-over-stdio服务器,将Obsidian笔记库暴露给LLM工具/代理,提供资源列表、读取、创建、搜索和导出笔记等功能。

  • by debjit-1004
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 debjit-1004/obsidian-mcp-server

使用说明

黑曜石mcp服务器(作用域包@debjit_kundu/obsidian mcp服务器)

一个轻量级的MCP风格的JSON over stdio服务器,它向LLM工具/代理公开了一个黑曜石保险库。它提供:

  • 资源列表(listResources)–每个标记注释都是一种资源
  • 阅读(readResource)
  • 工具: create_note, search_notes, export_all_notes
  • 文件监视事件:创建/更改/删除

安装(本地开发)

npm install
npm run build

全局安装(发布后)

npm install -g @debjit_kundu/obsidian-mcp-server
obsidian-mcp --vault /path/to/vault <<'EOF'
{"id":"1","method":"initialize","params":{"client":{"name":"cli"}}}
{"id":"2","method":"listResources"}
EOF

CLI选项

--vault <path>          Path to Obsidian vault (directory)
--set-default           Persist vault path in ~/.config/obsidian-mcp/config.json
--no-interactive        Fail instead of prompting for vault
--exit-on-eof           (default true) Exit after stdin closes

示例:创建并阅读笔记

obsidian-mcp --vault /path/to/vault <<'EOF'
{"id":"1","method":"initialize","params":{"client":{"name":"cli"}}}
{"id":"2","method":"callTool","params":{"name":"create_note","arguments":{"title":"hello","content":"Hello world"}}}
{"id":"3","method":"readResource","params":{"uri":"obsidian-vault:///hello.md"}}
EOF

导出所有笔记

obsidian-mcp --vault /path/to/vault <<'EOF'
{"id":"1","method":"initialize","params":{"client":{"name":"cli"}}}
{"id":"2","method":"callTool","params":{"name":"export_all_notes","arguments":{}}}
EOF

路线图

  • 分页+过滤
  • update_note/delete_note工具
  • 嵌入/语义搜索
  • 流式分块导出

许可证

麻省理工学院