Obsidian MCP

Obsidian MCP（模型上下文协议）

Obsidian MCP 是一款工具，允许您使用模型上下文协议 (MCP) 与 Obsidian Vault 进行交互。这使得 AI 助手能够通过标准化界面读取、写入和操作 Obsidian Vault 中的笔记。

先决条件

• Node.js 18 或更高版本
• 安装并配置了本地 REST API 插件的 Obsidian
• 从本地 REST API 插件生成的 API 密钥

设置 MCP 服务器（例如 Claude 桌面应用程序）

1. 克隆此存储库
2. 安装依赖项：
   npm install
3. 构建项目：
   npm run build
4. 配置 Claude 桌面应用程序以使用此 MCP 服务器：
   { "mcpServers": { "Obsidian": { "command": "node", "args": ["/Users/<Your Own Path>/obsisian-mcp/build/index.js"], "env": { "apiKey": "<Your API Token>", "port": "27123", "host": "127.0.0.1" } } } }

发展

创建.env并按照上面提到的配置“apiKey”、“port”和“host”。

可用工具

实施了以下工具：

1. readNote - 阅读特定注释的内容
   { "path": "path/to/note.md" }
2. readActiveNote - 读取当前活动笔记的内容
   {}
3. listNotes - 递归列出整个 Vault 中或指定文件夹下的文件和文件夹
   { "path": "optional/folder/path" }
4. patchNote - 将内容插入到相对于标题、块引用或前置字段的现有注释中
   { "path": "path/to/note.md", "operation": "append|prepend|replace", "targetType": "heading|block|frontmatter", "target": "target_identifier", "content": "content to insert" }
5. searchWithJsonLogic - 使用 JsonLogic 格式查询搜索 Obsidian 笔记
   { "query": { // JsonLogic query object } }