Obsidian MCP

MCP-сервер (Model Context Protocol), который предоставляет AI-ассистентам (Claude, Cursor и др.) доступ к вашему хранилищу Obsidian. Перемещайтесь по папкам, читайте заметки, создавайте, редактируйте, перемещайте, переименовывайте и удаляйте их — прямо из чата с AI.

Требования

• Python 3.10+

• uv (рекомендуется) или pip

• Хранилище Obsidian на вашем локальном компьютере

Related MCP server: mcp-obsidian

Установка

# Clone the repo
git clone https://github.com/your-username/obsidian-mcp
cd obsidian-mcp

# Copy the env template and set your vault path
cp .env.example .env

Отредактируйте .env и укажите путь к вашему хранилищу:

OBSIDIAN_VAULT_PATH="/Users/you/Documents/MyVault"

Чтобы узнать путь к хранилищу в Obsidian: Настройки → О программе → Путь к хранилищу.

Запуск сервера

Разработка (с MCP Inspector UI)

uv run mcp dev server.py

Это откроет MCP Inspector в вашем браузере, где вы сможете интерактивно протестировать все инструменты.

Продакшн

uv run server.py

Подключение к Cursor

Добавьте это в ваш .cursor/mcp.json (или в глобальные настройки MCP в Cursor):

{
  "mcpServers": {
    "obsidian": {
      "command": "python",
      "args": ["/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Замените /absolute/path/to/obsidian-mcp/server.py на фактический путь к server.py на вашем компьютере, а /path/to/your/vault — на путь к вашему хранилищу (его можно найти в Obsidian: Настройки → О программе → Путь к хранилищу).

Подключение к Claude Desktop

Добавьте это в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Доступные инструменты

Все пути указываются относительно корня хранилища, например "Projects/App/roadmap.md".

Лицензия

MIT