SoloMD
SoloMD — MCP-сервер сообщества (автор — zhitongblog). Чтение и поиск по папке заметок Markdown: обратные ссылки, теги, задачи, оглавления и история Git. Ставится из исходников. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- zhitongblog
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
По умолчанию только чтение; с --allow-write создаёт, дописывает и откатывает заметки, export_note пишет и вне хранилища.
Настройка клиентов
{
"code": "[mcp_servers.solomd-vault]\ncommand = \"solomd-mcp\"\nargs = [\"--workspace\", \"/Users/me/Documents/Notes\"]",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
solomd-mcp — MCP-сервер для хранилищ заметок SoloMD. Через него Claude Code, Codex CLI, Cursor, Continue и другие MCP-клиенты читают папку с Markdown-заметками, а при явном разрешении и редактируют её. Это отдельная программа на Rust. Настольное приложение SoloMD содержит её копию, но само не запускает: сервер стартует только по запросу MCP-клиента.
16 инструментов. По умолчанию доступно только чтение:
list_notes— заметки с метаданными (путь, заголовок, дата изменения, размер, краткое содержание), по умолчанию 100 новейших;read_note— полный текст заметки с front matter, заголовками, тегами и исходящими[[вики-ссылками]];search— поиск по подстроке или регулярному выражению (ripgrep, если он установлен), до 200 совпадений с контекстом;get_backlinks,list_tags,get_outline,list_tasks— обратные ссылки, теги, оглавление заметки и все чекбоксы задач;autogit_logиautogit_diff— история и изменения заметки по AutoGit;sync_status,share_url,read_agent_trace— состояние синхронизации с GitHub, публичная ссылка на заметку и шаги запуска агента.
Только с флагом --allow-write:
write_note— создать заметку (перезаписать существующую можно лишь сallow_overwrite: true);append_to_note— дописать текст;autogit_rollback— восстановить заметку из коммита AutoGit;export_note— экспорт в html, md, txt или docx. Нужны Node.js и исходники SoloMD.
С версии 4.0 поддерживается несколько хранилищ в одном сервере: каждому даётся псевдоним вида work=/путь.
Кому подойдёт
- Пользователям SoloMD: ассистент ищет по заметкам, находит связи и задачи.
- Тем, кто ведёт базу знаний в Markdown: работа с вики-ссылками и тегами из чата.
- Тем, кому нужна осторожная настройка: по умолчанию только чтение, запись включается явно.
Похожие серверы — в категории знания и память.
Установка
Установщик для macOS и Linux скачивает бинарник из последнего релиза в /usr/local/bin/solomd-mcp или ~/.local/bin/solomd-mcp:
curl -fsSL https://raw.githubusercontent.com/zhitongblog/solomd/main/scripts/install-mcp.sh | bashЕсть и другие способы: Cargo (cargo install --git https://github.com/zhitongblog/solomd solomd-mcp) или архив со страницы релизов. Обязательный параметр — --workspace с путём к папке заметок.
Подключение к клиентам
Команда и конфиги приведены дословно из README. Замените путь на свою папку. Общий порядок — в инструкции как подключить MCP.
claude mcp add --scope user solomd-vault -- \
solomd-mcp --workspace /Users/me/Documents/NotesЧтобы разрешить запись, добавьте --allow-write в args. Для Cursor, Continue и других клиентов укажите команду solomd-mcp с --workspace. CLI solomd умеет прописать эту запись во все найденные клиенты командой solomd mcp install. Для облачных клиентов есть транспорт HTTP: --transport http.
Проверка
Попросите агента показать последние заметки — сработает list_notes. Сервер должен показать 16 инструментов, или 15, если для export_note нет Node.js.
Примеры задач
Найди все незакрытые задачи в заметках и сгруппируй их по файлам.Какие заметки ссылаются на «План запуска»? Покажи историю её изменений.Риски
Сервер читает заметки в указанной папке. С --allow-write он создаёт, дописывает и откатывает заметки, а export_note может записать файл и за пределами хранилища. Защита по README: все пути проверяются, .. и абсолютные пути вне хранилища отклоняются, перезапись возможна только с явным флагом. Запись включайте, только когда она действительно нужна. Если запускаете HTTP-транспорт, оставьте адрес 127.0.0.1 и задайте --auth-token (или SOLOMD_MCP_TOKEN): без токена эндпоинт открыт всем, кто до него дотянется. Заметки — недоверенные данные для агента.
Частые вопросы
Может ли агент случайно изменить заметки?
Нет, по умолчанию сервер только читает. Инструменты записи работают лишь после запуска с --allow-write.
Можно ли подключить несколько хранилищ?
Да. Передайте --workspace несколько раз в форме псевдоним=путь. Первое хранилище будет основным.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.