eddmann/obsidian-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

15 stars 12 forks 品質 70 トレンド 21MIT

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.

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

GitHub で README 全文を見る

インストール

docker run -i --rm -v /ABSOLUTE/PATH/TO/obsidian-mcp.env:/app/.env ghcr.io/eddmann/obsidian-mcp:latest stdio

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "obsidian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/ABSOLUTE/PATH/TO/obsidian-mcp.env:/app/.env",
        "ghcr.io/eddmann/obsidian-mcp:latest",
        "stdio"
      ]
    }
  }
}