newtype-01/obsidian-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

308 stars 49 forks 质量 66 趋势 19MIT

Repository Install

newtype-01/obsidian-mcp 是从 https://github.com/newtype-01/obsidian-mcp. 导入的 MCP 服务器候选

概览

newtype-01/obsidian-mcp 是从 https://github.com/newtype-01/obsidian-mcp. 导入的 MCP 服务器候选

概述（AI 翻译）

英文 |中文

该项目实现了一个模型上下文协议（MCP）服务器，用于连接 AI 模型与 Obsidian 知识库。通过该服务器，AI 模型可以直接访问和操作 Obsidian 笔记，包括读取、创建、更新和删除笔记，以及管理文件夹结构。

黄一合创作

提示之家：https://prompthouse.app/
YouTube：https://www.youtube.com/@huanyihe777
推特：https://x.com/huangyihe
社区：https://t.zsxq.com/19IaNz5wK

特色

** 🔗 无缝 Obsidian 集成**：通过 MCP 协议直接访问 Obsidian 知识库
** 📝 完整的笔记管理**：通过高级文本替换读取、创建、更新和删除笔记
** 📁 文件夹操作**：创建、重命名、移动和删除支持完整层级的文件夹
** 🔍 智能搜索**：全文搜索，涵盖所有文件类型，并支持智能评分
** 🤖 人工智能驱动分析**：新利用TRILEMMA-PRINCIPLES框架的战略洞察
** 🔗 自动反向链接生成**：新智能检测并转换笔记名称为维基链接
** ⚡ 精准编辑**：高级PATCH操作，包含航向和区块级目标定位

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Obsidian MCP (Model Context Protocol) Server

English | 中文

This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.

Created by huangyihe

Prompt House: https://prompthouse.app/
YouTube: https://www.youtube.com/@huanyihe777
Twitter: https://x.com/huangyihe
Community: https://t.zsxq.com/19IaNz5wK

Features

🔗 Seamless Obsidian Integration: Direct access to Obsidian knowledge bases through MCP protocol
📝 Complete Note Management: Read, create, update, and delete notes with advanced text replacement
📁 Folder Operations: Create, rename, move, and delete folders with full hierarchy support
🔍 Intelligent Search: Full-text search across all file types with smart scoring
🤖 AI-Powered Analysis: NEW Strategic insights using TRILEMMA-PRINCIPLES framework
🔗 Auto Backlink Generation: NEW Intelligent detection and conversion of note names to wikilinks
⚡ Precision Editing: Advanced PATCH operations with heading and block-level targeting
🚀 Dual API Strategy: Obsidian REST API with filesystem fallback for maximum reliability
🎯 Context Optimization: Smart content summarization for LLM context length management
📊 Batch Processing: Efficient bulk operations with progress tracking

Supported Tools

The MCP server provides the following comprehensive tools:

📋 Core Operations

list_notes: List notes in the Obsidian vault with optional folder filtering
- NEW recursive parameter: Control whether to list files recursively in subdirectories (default: true)
- Use recursive: false to list only files in the specified folder without subdirectories
read_note: Read the content of a specific note in the Obsidian vault
read_multiple_notes: Read content from multiple notes simultaneously for batch processing
create_note: Create a new note in the Obsidian vault with full content
delete_note: Delete a note from the Obsidian vault
search_vault: Advanced search across all file types with filename and content matching
move_note: Move or rename notes to new locations (supports all file types including PDFs)
manage_folder: Complete folder CRUD operations (create/rename/move/delete)

🚀 Advanced Features

update_note: Enhanced Update content using text replacements OR precision insertion
- Traditional text replacement mode
- NEW Heading-based insertion (before/after/append/prepend)
- NEW Block ID-based insertion with ^block-id support
- NEW PATCH API integration with filesystem fallback
auto_backlink_vault: 🔗 Auto Backlink Generation
- Intelligently scan entire vault for note name mentions

在 GitHub 查看完整 README

安装

npx @huangyihe/obsidian-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "@huangyihe/obsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
        "OBSIDIAN_API_TOKEN": "your_api_token",
        "OBSIDIAN_API_PORT": "27123"
      }
    }
  }
}