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 пишет и вне хранилища.

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

codex
{
    "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 для ИИ-ассистента.

Риск: 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

Источники