mcpField
O
Obsidian MCP Lite

Obsidian MCP Lite

本地服务
github.com/yokarilight记忆与知识178 周前更新

关于 Obsidian MCP Lite

Obsidian MCP Lite 是一个用于操作 Obsidian 库的 TypeScript MCP 服务。它通过 Obsidian 的 Local REST API 支持文件浏览、文本搜索和内容编辑。

主要功能

  1. 01列出库及目录中的文件
  2. 02读取文件内容
  3. 03搜索文件中的文本
  4. 04修改或追加内容
  5. 05删除文件

适用场景

  1. 01浏览 Obsidian 库中的文件
  2. 02在库文件中查找文本
  3. 03更新或追加笔记
  4. 04删除库中的文件

MCP 相关

通过 Obsidian Local REST API 向 MCP 客户端提供库文件的列出、读取、搜索、编辑和删除功能。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"obsidian-map-lite": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector"
]
}
}
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Obsidian MCP Lite

一个基于 TypeScript 的 MCP 服务,为 Obsidian 提供与 Obsidian 库交互的简单接口。

功能

  • 列出库中的文件
  • 列出目录中的文件
  • 获取文件内容
  • 搜索文件中的特定文本
  • 修补内容
  • 追加内容
  • 删除文件

前提条件

  • Node.js >= 18.16.0
  • 已安装 Local REST API 插件的 Obsidian
  • Obsidian API 密钥

设置

# Install dependencies
pnpm install

# Build server
pnpm run build

配置

  1. 将 .env.example 复制为 .env:

    cp .env.example .env
    
  2. 编辑 .env 并设置 Obsidian API 密钥和主机:

    OBSIDIAN_API_KEY=your-api-key-here
    OBSIDIAN_HOST=http://localhost:27123
    

安装

若要与 Cursor 配合使用,请添加以下配置:

{
  "mcpServers": {
    "obsidian-mcp-lite": {
      "command": "node",
      "args": [
        "/path/to/obsidian-mcp-lite/dist/index.js"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

调试

使用 MCP Inspector:

npx @modelcontextprotocol/inspector -e OBSIDIAN_API_KEY=your-api-key-here node dist/index.js"

终端中会显示一个 URL。打开该 URL,即可在浏览器中访问调试工具。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。