aaronsb/obsidian-mcp-plugin

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

467 stars 54 forks 품질 78 트렌드 40MIT

Repository Install

Obsidian용 고성능 모델 컨텍스트 프로토콜(MCP) 서버로, 의미 연산과 HTTP 전송을 통해 AI 도구에 직접적인 볼트 접근을 제공합니다.

개요

외부 Node 프로세스를 실행할 필요도, 별도의 REST-API 플러그인을 연결할 필요도 없습니다. 서버가 플러그인입니다. 설정은 드래그 앤 드롭으로 — .mcpb 번들을 Claude Desktop에 넣고, 키를 붙여넣으면 끝납니다. 각 작업은 단일 호출이 아니라 전체 연산 군을 제공합니다(볼트 도구만 13개 작업을 처리합니다: 리스트, 읽기, 생성, 검색, 이동, 분할, 결합 등). 이는 일류 지원과 링크, 태그, 백링크 간 그래프 횡단 기능을 제공합니다. 모든 작업은 사용자가 설정한 권한을 존중합니다 — 읽기 전용 모드, 작업별 제어, 경로 허용/차단 목록 — 따라서 AI는 당신이 허용한 것만 수행하며, 금고를 제한 없이 실행하지 않습니다. — 클로드 데스크톱, 클로드 코드, 클라인, Continue.dev, 그리고 로컬 MCP를 사용하는 모든 것. 모델 컨텍스트 프로토콜은 AI 비서가 외부 도구 및 데이터와 상호작용할 수 있도록 하는 오픈 표준입니다. 이를 사용하기 위해 이해할 필요는 없습니다 — 퀵 스타트는 세 단계로 이루어져 있습니다.

개요(AI 번역)

📦 Obsidian 커뮤니티 플러그인 디렉토리에서 이용 가능→

어떤 AI 어시스턴트를 통해 Obsidian 금고를 읽고, 쓰고, 검색하고, 탐색할 수 있습니다 — 내부 Obsidian에서 실행되는 MCP 서버를 통해 말이죠.

외부 노드 프로세스를 실행할 필요도, 별도의 REST-API 플러그인을 연결할 필요도 없습니다: 서버가 플러그인 그 자체입니다. 설정은 드래그 앤 드롭으로 — .mcpb 번들을 Claude Desktop에 놓고, 키를 붙여넣으면 끝납니다.

이 도구는 8개의 강력한 도구를 제공합니다 — 각각은 단일 호출이 아닌 전체 연산 계열입니다(vault 도구만 13개를 처리합니다: 리스트, 읽기, 생성, 검색, 이동, 분할, 결합 등). - 일류 Dataview와 Bases 지원, 링크, 태그, 백링크를 통한 그래프 탐색도 지원합니다. 모든 작업은 당신이 설정한 권한 — 읽기 전용 모드, 각 작업 제어 기능, 경로 허용/차단 목록 — 을 존중하므로, AI는 당신이 허용한 것만 수행하고, 금고를 제한 없이 실행하지 않습니다.

모든 MCP 호환 클라이언트에서 작동 — Claude Desktop, Claude Code, Cline, Continue.dev 및 로컬 MCP를 사용하는 모든 기기.

MCP 초보자인가요? 모델 컨텍스트 프로토콜은 AI 비서가 외부 도구 및 데이터와 상호작용할 수 있도록 하는 오픈 표준입니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Semantic Notes Vault MCP

📦 Available in the Obsidian Community Plugin directory →

Read, write, search, and traverse your Obsidian vault from any AI assistant — through an MCP server that runs inside Obsidian.

No external Node process to launch, no separate REST-API plugin to bridge through: the server is the plugin. Setup is a drag-and-drop — drop the .mcpb bundle onto Claude Desktop, paste your key, done.

It exposes 8 powerful tools — each a whole family of operations, not a single call (the vault tool alone handles 13: list, read, create, search, move, split, combine, and more) — with first-class Dataview and Bases support plus graph traversal across links, tags, and backlinks. And every operation respects the permissions you set — a read-only mode, per-operation controls, and path allow/block lists — so the AI only ever does what you’ve allowed, not unrestricted run of your vault.

Works with any MCP-compatible client — Claude Desktop, Claude Code, Cline, Continue.dev, and anything that speaks local MCP.

New to MCP? The Model Context Protocol is the open standard that lets AI assistants interact with external tools and data. You don’t need to understand it to use this — the Quick Start is three steps.

Quick Start

Prerequisites: an MCP-compatible AI client like Claude Desktop, Claude Code, or Continue.dev.

📦 ──drag──▶ 🤖💬

Download the .mcpb bundle from the plugin’s config page → drag it onto Claude Desktop → paste your key. Done.

For most people that’s the entire setup. The numbered steps below spell it out, then cover other MCP clients.

1. Install the Plugin

Via Obsidian Community Plugins

Open Settings → Community plugins → Browse
Search for “Semantic Notes Vault MCP”
Install and enable — or install straight from the plugin listing

Via BRAT (for beta testing)

Install BRAT
Add beta plugin: aaronsb/obsidian-mcp-plugin

2. Configure Your AI Client

Three onboarding paths, ordered by audience. All three are also shown in the plugin’s Settings tab with copy-ready values.

📦 → 🤖 Claude Desktop — one-click .mcpb install (recommended)

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "obsidian-vault": {
      "transport": {
        "type": "http",
        "url": "http://localhost:3001/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}