Obsidian MCP（模型上下文协议）

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

先决条件

• Node.js 18 或更高版本

• 安装并配置了本地 REST API 插件的 Obsidian

• 从本地 REST API 插件生成的 API 密钥

Related MCP server: MCP Obsidian

设置 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
     }
   }