Skip to main content
Glama
andysama-work

Obsidian MCP Server

by andysama-work
OverviewSchemaRelated ServersScoreDiscussions
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 MCP Tool Server

🚀 安装

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

无需安装，直接在 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

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
2dRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/andysama-work/obsidian-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server