obsidian-github-mcp

obsidian-github-mcp — MCP-сервер сообщества (автор — Hint-Services). Доступ ИИ-ассистента к хранилищу Obsidian на GitHub: поиск и анализ заметок. Ставится через npx. Доступен и как удалённый сервер. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Hint-Services
Лицензия
MIT
Транспорт
streamable_http
Авторизация
token_env
ОС
Не указана
Языки
typescript

Уровень риска: medium

Читает репозиторий с правами токена; право `repo` открывает все приватные репозитории аккаунта. Выдавайте токен с минимальными правами.

Настройка клиентов

cursor
{
    "code": "npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client cursor",
    "lang": "bash",
    "notes": "Установка через Smithery, дословно из README",
    "verified": "docs"
}

Что умеет

Obsidian GitHub MCP подключает ИИ-ассистента к репозиторию GitHub, в котором хранится хранилище Obsidian. Многие пользователи Obsidian держат заметки на GitHub для резервного копирования, версий и совместной работы, и этот сервер даёт ассистенту доступ к такой базе знаний.

Инструменты:

  • getFileContents — содержимое конкретных заметок, документов и файлов из хранилища;
  • searchFiles — поиск в нескольких режимах: filename (точное имя файла), path (по пути), content (по тексту) и all (по всему сразу);
  • searchIssues — поиск задач и обсуждений, связанных с проектами базы знаний;
  • getCommitHistory — история коммитов с диффами, чтобы видеть, как развивались заметки и идеи.

Сервер написан на TypeScript, входные данные проверяются схемами Zod. Совместим с Claude, Cursor, Windsurf, Cline и другими MCP-клиентами.

Кому подойдёт

  • Исследователям и авторам: ассистент находит нужные заметки, источники и черновики в хранилище.
  • Разработчикам: доступ к технической документации и учебным заметкам с примерами кода.
  • Студентам: конспекты лекций и материалы для подготовки.
  • Командам с общей базой знаний на GitHub.

Похожие серверы — в категории знания и память.

Установка

Проще всего установить сервер через Smithery (команды ниже). Ручная установка — пакет obsidian-github-mcp через npm и блок mcpServers с командой npx -y obsidian-github-mcp.

Нужны три переменные:

  • GITHUB_TOKEN — персональный токен GitHub с правом repo для приватных репозиториев или public_repo для публичных;
  • GITHUB_OWNER — владелец или организация репозитория;
  • GITHUB_REPO — имя репозитория с хранилищем Obsidian.

Подключение к клиентам

Команды приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client claude

Для ручной настройки добавьте в конфиг клиента блок с командой npx, аргументами -y obsidian-github-mcp и тремя переменными выше.

Проверка

Попросите ассистента найти заметку по имени файла, например «OKR 2025». Он вызовет searchFiles в режиме filename. Ошибка доступа означает, что токен не видит репозиторий или неверно указаны владелец и имя.

Примеры задач

Найди в моём хранилище заметки про OKR 2025 и перескажи цели.
Как менялась заметка «Идеи для статьи» за последний месяц? Покажи историю коммитов.

Риски

Сервер читает содержимое репозитория с правами вашего токена. Токен с правом repo открывает доступ ко всем приватным репозиториям аккаунта, а не только к хранилищу Obsidian. Личные заметки попадают в контекст ассистента.

Как снизить риски: создайте токен с минимальными правами, по возможности ограниченный одним репозиторием, храните его в переменных окружения и не подключайте хранилища с конфиденциальными данными. Лицензия — MIT.

Частые вопросы

Нужен ли Obsidian на компьютере?

Нет. Сервер работает с репозиторием GitHub, где лежит хранилище.

Какие права нужны токену?

repo для приватного репозитория или public_repo для публичного.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • getFileContents
  • searchFiles
  • searchIssues
  • getCommitHistory

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники