carnetdethese/obsidian-mcp

开发工具

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

0 stars 8 forks 质量 67 趋势 0MIT

Repository Install

MCP Server for Obsidian

概览

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your Obsidian vault. This server provides tools for reading, creating, searching, and managing notes in Obsidian through the Local REST API plugin. - 📖 - Full access to your Obsidian vault with automatic overwrite protection - 🔍 - Find notes by content, tags, or modification date - 📁 - List and navigate your notes and folders by directory - 🏷️ - Add, remove, and organize tags (supports both frontmatter and inline tags) - 🔗 - Find backlinks, analyze outgoing links, and identify broken links - 📊 - Get statistics like word count and link analysis - 🎯 - Clear error messages and smart defaults for better AI interactions - 🔒 - API key authentication with local-only connections - ⚡ - Concurrent operations and batching for large vaults - 🚀 - Create folder hierarchies and move entire folders with all their contents - with the Local REST API plugin installed and enabled - installed on your...

README

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

Obsidian MCP Server

Features

📖 Read & write notes - Full access to your Obsidian vault with automatic overwrite protection
🔍 Smart search - Find notes by content, tags, or modification date
📁 Browse vault - List and navigate your notes and folders by directory
🏷️ Tag management - Add, remove, and organize tags (supports both frontmatter and inline tags)
🔗 Link management - Find backlinks, analyze outgoing links, and identify broken links
📊 Note insights - Get statistics like word count and link analysis
🎯 AI-optimized - Clear error messages and smart defaults for better AI interactions
🔒 Secure - API key authentication with local-only connections
⚡ Performance optimized - Concurrent operations and batching for large vaults
🚀 Bulk operations - Create folder hierarchies and move entire folders with all their contents

Prerequisites

Obsidian with the Local REST API plugin installed and enabled
Python 3.10+ installed on your system
Node.js (optional, for running MCP Inspector)

Installation

Quick Install

Install and configure Obsidian:
- Install the Local REST API plugin in Obsidian
- Enable the plugin in Settings > Community plugins
- Go to Settings > Local REST API
- Copy your API key (you’ll need this for step 2)
Configure your AI tool:

Edit your Windsurf config file:
- Location: ~/.codeium/windsurf/mcp_config.json
```
{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
```

在 GitHub 查看完整 README

安装

uvx obsidian-mcp

新手？先看 mcpskill.org 教程 →

配置

{
     "mcpServers": {
       "obsidian": {
         "command": "uvx",
         "args": ["obsidian-mcp"],
         "env": {
           "OBSIDIAN_REST_API_KEY": "your-api-key-here"
         }
       }
     }
   }