EO

eddmann/obsidian-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

15 stars 12 forks Качество 70 Тренд 21MIT

MCP-сервер для поддерживаемых git сводов Obsidian. Доступ и управление заметками через Claude, ChatGPT и другие LLM с автоматической синхронизацией git. Поддержка локального (stdio/HTTP) и удаленного (AWS Lambda) развертывания.

Обзор

Сервер Model Context Protocol (MCP) для поддерживаемых git сводов Obsidian. Получите доступ и управляйте своими заметками через Claude, ChatGPT и другие LLM, синхронизируя изменения через git. Этот сервер MCP обеспечивает и взаимодействует с вашим хранилищем Obsidian через LLM: - 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 management tags - Journal Logging (1) - Autolog LLM activity to daily journals - Stdio - локальное развертывание для Claude Desktop, Cursor - HTTP - локальное / удаленное с OAuth для ChatGPT, Claude web - AWS Lambda - бессерверное развертывание с сессиями DynamoDB Начните с Claude Desktop в 3 шага с помощью Docker: macOS: ~/Library/Application Support/Claude/claude desktop config.json Windows: %APPDATA%\Claude\claude desktop config.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для поддерживаемых git сводов Obsidian. Получите доступ и управляйте своими заметками через Claude, ChatGPT и другие LLM, синхронизируя изменения через git.

Таблица содержимого

  • Обзор Быстрый старт
  • Как это работает
  • Предварительные условия
  • Варианты развертывания Claude Desktop (Местный) ChatGPT и удаленные клиенты AWS Lambda
  • Примеры использования
  • Ссылка на инструмент
  • Ресурсы
  • Документация
  • Лицензия

Обзор

Этот сервер MCP предоставляет 18 инструментов и 1 ресурс для взаимодействия с вашим хранилищем Obsidian через LLM:

Категории инструментов:

  • Операции с файлами (9) - читать, создавать, редактировать, удалять, перемещать, добавлять и патчи
  • Операции с каталогами (3) - Создание каталогов и списков файлов
  • Поиск (1) - Нечеткий поиск с оценкой релевантности и точным соответствием Управление тегами (4) - Добавлять, удалять, переименовывать и управлять тегами Журналирование (1) - Автолог активности LLM для ежедневных журналов

Режимы развертывания:

Stdio - локальное развертывание для Claude Desktop, Cursor HTTP - локальный / удаленный с OAuth для ChatGPT AWS Lambda - развертывание без сервера с сессиями DynamoDB

Быстрый старт

Начните с Claude Desktop в 3 шага с помощью Docker:

**3. Добавить конфигурацию Claude Desktop: **

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

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
Открыть полный README на GitHub

Установка

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" ] } } }