Skip to main content
Glama
Sign In
Obsidian MCP Server

Obsidian MCP Server

by andysama-work
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Obsidian MCP Server

将你的 Obsidian 笔记库暴露为 MCP 服务，让 AI 助手可以搜索和读取你的笔记。

✨ 功能

工具

描述

search_notes

按关键词、标签、分类搜索笔记

read_note

读取指定笔记的完整内容

list_folder

列出文件夹下的笔记和子文件夹

get_note_structure

获取笔记库目录结构

full_text_search

在所有笔记中全文搜索

create_note

创建新笔记

update_note

更新已存在的笔记

delete_note

删除指定笔记

create_folder

创建新文件夹

get_prompt_guide

获取知识库整理助手提示词的使用指南

Related MCP server: obsidian-vault-mcp

🚀 安装

方式一：直接使用（推荐）

无需安装，直接在 MCP 配置中使用 npx：

{
  "mcpServers": {
    "obsidian-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@andysama/obsidian-mcp-server",
        "--vault",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

方式二：全局安装

npm install -g @andysama/obsidian-mcp-server

方式三：从源码构建

git clone https://github.com/andysama-work/obsidian-mcp-server.git
cd obsidian-mcp-server
npm install
npm run build

⚙️ 配置

Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "obsidian-notes": {
      "command": "node",
      "args": [
        "/path/to/obsidian-mcp-server/dist/index.js",
        "--vault",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

Windsurf / Cursor

在 MCP 配置文件中添加：

{
  "mcpServers": {
    "obsidian-notes": {
      "command": "node",
      "args": [
        "/path/to/obsidian-mcp-server/dist/index.js",
        "--vault",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

⚠️ 请将 /path/to/your/obsidian/vault 替换为你的 Obsidian 笔记库实际路径

📖 使用示例

配置完成后，AI 助手可以：

  • 搜索笔记：搜索关于 STM32 的笔记

  • 读取内容：读取 STM32系列选型速查.md

  • 浏览结构：列出硬件学习文件夹的内容

  • 全文搜索：在笔记中搜索 "定时器"

  • 创建文件夹：在知识点目录下创建一个新文件夹

  • 获取提示词指南：告诉我如何使用知识库整理助手提示词

🛠️ 开发

# 安装依赖
npm install

# 构建
npm run build

# 测试运行（需指定 vault 路径）
node dist/index.js --vault "/path/to/vault"

📝 Frontmatter 支持

本工具会解析笔记的 YAML Frontmatter，支持以下字段：

---
category: hardware
tags: [STM32, 嵌入式]
summary: 笔记摘要
folder: 知识点/03-硬件学习/
created: 2024-12-18
---

📄 License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • obsidian-rag-mcp

      LIPiston
      F
      license
      A
      quality
      D
      maintenance
      Exposes Obsidian notes as a semantic search and RAG knowledge base over MCP, enabling AI assistants to index, retrieve, and analyze personal notes via natural language.
      7
      1
      -

    • obsidian-vault-mcp

      JulioMCruz
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to list, read, search, create, update, rename, and delete markdown notes in a local Obsidian vault via an HTTP MCP endpoint.
      18 npm
      1
      MIT

    • obsidian-mcp

      laurentiudanielgi-coder
      A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to safely read, search, create, edit, delete, and move notes in an Obsidian vault, with automatic link repair and reversible deletes.
      10
      3,585 npm
      MIT

    • vault-mcp

      abhaymettu
      F
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to search, read, list, and append to markdown notes in a local Obsidian vault or folder of .md files.
      -