
eddmann/obsidian-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP server for git-backed Obsidian vaults. Access and manage notes through Claude, ChatGPT, and other LLMs with automatic git sync. Supports local (stdio/HTTP) and remote (AWS Lambda) deployment.
개요
A Model Context Protocol (MCP) server for git-backed Obsidian vaults. Access and manage your notes through Claude, ChatGPT, and other LLMs by syncing changes via git. This MCP server provides and to interact with your Obsidian vault through LLMs: - File Operations (9) - Read, create, edit, delete, move, append, and patch notes - Directory Operations (3) - Create directories and list files - Search (1) - Fuzzy search with relevance scoring and exact matching - Tag Management (4) - Add, remove, rename, and manage tags - Journal Logging (1) - Auto-log LLM activity to daily journals - Stdio - Local deployment for Claude Desktop, Cursor - HTTP - Local/remote with OAuth for ChatGPT, Claude web - AWS Lambda - Serverless deployment with DynamoDB sessions Get started with Claude Desktop in 3 steps using Docker: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.
README
원문 README의 일부입니다. 원문 보기.
Obsidian MCP Server
A Model Context Protocol (MCP) server for git-backed Obsidian vaults. Access and manage your notes through Claude, ChatGPT, and other LLMs by syncing changes via git.
Table of Contents
- Overview
- Quick Start
- How It Works
- Prerequisites
- Deployment Options
- Usage Examples
- Tool Reference
- Resources
- Documentation
- License
Overview
This MCP server provides 18 tools and 1 resource to interact with your Obsidian vault through LLMs:
Tool Categories:
- File Operations (9) - Read, create, edit, delete, move, append, and patch notes
- Directory Operations (3) - Create directories and list files
- Search (1) - Fuzzy search with relevance scoring and exact matching
- Tag Management (4) - Add, remove, rename, and manage tags
- Journal Logging (1) - Auto-log LLM activity to daily journals
Deployment Modes:
- Stdio - Local deployment for Claude Desktop, Cursor
- HTTP - Local/remote with OAuth for ChatGPT, Claude web
- AWS Lambda - Serverless deployment with DynamoDB sessions
Quick Start
Get started with Claude Desktop in 3 steps using Docker:
# 1. Download the example environment file
curl -O https://raw.githubusercontent.com/eddmann/obsidian-mcp/main/.env.example
mv .env.example obsidian-mcp.env
# 2. Edit obsidian-mcp.env with your vault repo and git token
# Required fields:
# VAULT_REPO=https://github.com/username/vault-repo.git
# VAULT_BRANCH=main
# GIT_TOKEN=your_token_here
3. Add to Claude Desktop config:
Restart Claude Desktop and start chatting with your vault!
# 1. Clone and install
git clone https://github.com/eddmann/obsidian-mcp
cd obsidian-mcp
npm install
# 2. Configure credentials
cp .env.example .env
설치
docker run -i --rm -v /ABSOLUTE/PATH/TO/obsidian-mcp.env:/app/.env ghcr.io/eddmann/obsidian-mcp:latest stdio설정
{
"mcpServers": {
"obsidian": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/ABSOLUTE/PATH/TO/obsidian-mcp.env:/app/.env",
"ghcr.io/eddmann/obsidian-mcp:latest",
"stdio"
]
}
}
}