CO

cyanheads/obsidian-mcp-server

开发工具

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

698 stars 108 forks 质量 91 趋势 41Apache-2.0

通过MCP阅读、写作、搜索并彻底编辑Obsidian vault的笔记、标签和前置文件。STDIO或可流式HTTP。

概览

obsidian-mcp-server 通过MCP读取、写入、搜索并进行精准编辑Obsidian vault的笔记、标签和前置文件。STDIO或可流式HTTP。14个工具 • 3个资源 十四个按形状分组的工具——读者抓取笔记和元数据,写作者创建或粗糙编辑内容,管理者协调标签和前置内容,而一个守卫的逃生口则发送Obsidian命令调色板命令。 阅读四种预测之一的备注,按保险库路径、活跃文件或定期备注(每日、每周、每月、季度、每年)处理。

概述(AI 翻译)

黑曜石-MCP-服务器 通过MCP阅读、写作、搜索并彻底编辑Obsidian vault的笔记、标签和前置文件。STDIO或可流式HTTP。 14 工具 • 3 资源


概述

通过本地 REST API 插件运行 Obsidian Vault 笔记。读取、搜索和写笔记,编辑单一标题、块和前置字段,管理标签,内置文件夹范围的读写权限。作为 stdio 进程或本地可流式 HTTP 服务器运行。

工具

工具 描述
obsidian_get_note 将笔记阅读为原始内容、完整结构表、文档地图或单一节
obsidian_list_notes 递归地将笔记和文件夹列入保险库路径,并带有扩展和名称过滤器
obsidian_list_tags 列出带有使用次数的保险库标签,最常用者排第一
obsidian_search_notes 当该插件可访问时,可通过文本、JSONLogic 或 BM25 排名的 Omnisearch 搜索
obsidian_write_note 创建注释、替换一个部分,或覆盖整个文件 overwrite: true
obsidian_append_to_note 附加到注释(如果缺少则创建)或附加到某个标题、块或前言字段

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

README

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


Overview

Your Obsidian vault, through the Local REST API plugin. Read, search, and write notes, edit a single heading, block, or frontmatter field in place, and manage tags, with folder-scoped read/write permissions built in.

Tools

Tool Description
obsidian_get_note Read a note as raw content, full structured form, document map, or a single section
obsidian_list_notes List notes and folders under a vault path, recursively, with extension and name filters
obsidian_list_tags List vault tags with usage counts, most-used first
obsidian_search_notes Search by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable
在 GitHub 查看完整 README

安装

npx -y obsidian-mcp-server
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "obsidian-mcp-server": { "command": "npx", "args": ["-y", "obsidian-mcp-server"], "env": { "OBSIDIAN_API_KEY": "your-api-key" } } } }