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` открывает все приватные репозитории аккаунта. Выдавайте токен с минимальными правами.
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.