MarkusPfundstein/mcp-obsidian

这是什么？

核心功能

• 01列出笔记库根目录或指定文件夹中的文件和目录。
• 02读取单个笔记的完整内容。
• 03在笔记库所有文件中进行文本搜索。
• 04按标题、块引用或 frontmatter 字段向笔记插入内容。
• 05向新建或已有文件追加内容，并可删除文件或目录。

适用场景

• 让 AI 助手总结或解释 Obsidian 中保存的笔记。
• 在笔记库中搜索某个主题的所有提及并查看上下文。
• 基于已有笔记自动生成新的会议纪要笔记。
• 让 AI 助手维护和更新个人知识库中的笔记。

快速上手

1. 1

   安装并启用 Obsidian Local REST API 社区插件，然后复制其 API 密钥

2. 2

   在 MCP 客户端配置中添加该服务器，并设置 OBSIDIAN_API_KEY、OBSIDIAN_HOST 和 OBSIDIAN_PORT

3. 3

   使用 uvx 运行已发布的服务器

   uvx mcp-obsidian

使用前须知

• !需要在 Obsidian 中安装并运行 Obsidian Local REST API 社区插件。
• !需要 Python 3.11 或更高版本，且 mcp 依赖必须保持在 2.0 以下。

收录于专题

标签

常见问题

mcp-obsidian 是什么？

让 AI 助手通过 Local REST API 插件读取、搜索、追加和删除 Obsidian 笔记库内容的 MCP 服务器。 mcp-obsidian 是一个 Model Context Protocol（MCP）服务器，可将 Claude Desktop 等 AI 客户端接入 Obsidian 笔记库。它通过 Obsidian 的 Local REST API 社区插件工作，因此需要 Obsidian 处于运行状态，启用该插件并配置 API 密钥。

mcp-obsidian 可以免费使用吗？用的什么许可证？

mcp-obsidian 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

mcp-obsidian 还在维护吗？

半年内有更新。mcp-obsidian 最近一次提交是在 2026年8月31日。

mcp-obsidian 适合用来做什么？

让 AI 助手总结或解释 Obsidian 中保存的笔记。 在笔记库中搜索某个主题的所有提及并查看上下文。 基于已有笔记自动生成新的会议纪要笔记。 让 AI 助手维护和更新个人知识库中的笔记。

mcp-obsidian 怎么安装和运行？

安装并启用 Obsidian Local REST API 社区插件，然后复制其 API 密钥 在 MCP 客户端配置中添加该服务器，并设置 OBSIDIAN_API_KEY、OBSIDIAN_HOST 和 OBSIDIAN_PORT 使用 uvx 运行已发布的服务器: uvx mcp-obsidian

在哪里获取 mcp-obsidian？

源代码和安装说明在 GitHub 上：https://github.com/MarkusPfundstein/mcp-obsidian