SoloMD MCP

Установка

Работает в

• Claude Code
• Codex
• Cursor
• SourceCraft
• Koda
• Coddy

Ручная установка

curl -fsSL https://raw.githubusercontent.com/zhitongblog/solomd/main/scripts/install-mcp.sh | bash

Что делает

`solomd-mcp` — отдельная программа на Rust, которая делает папку с заметками в Markdown инструментом для агента. Запускается клиентом MCP с указанием папки: `solomd-mcp --workspace /Users/me/Documents/Notes`, обмен идет по stdio. Настольный редактор SoloMD кладет копию такой программы внутрь приложения, но сам ее не запускает: сервер стартует только по требованию клиента. Редактор для работы не нужен: хватит обычных файлов. По умолчанию сервер только читает. Инструмент `list_notes` перечисляет заметки с названием, размером и кратким описанием, `read_note` отдает текст, заголовки, теги и исходящие ссылки `[[вики]]`, `search` ищет подстроку или регулярное выражение (через ripgrep, если он есть в `PATH`). Остальные читают структуру: `get_backlinks`, `list_tags`, `get_outline`, `list_tasks` с флажками `- [ ]` и `- [x]`. Историю версий заметки показывают `autogit_log` и `autogit_diff`. С ключом `--allow-write` включаются `write_note`, `append_to_note`, `autogit_rollback` и `export_note`. Можно подключить несколько папок параметром `--workspace алиас=путь`, первая считается основной. Для клиентов, которые не запускают локальные программы, есть режим `--transport http`.

Для кого. Для тех, кто ведет заметки, дневник или базу знаний в Markdown и хочет, чтобы Claude Code, Codex, Cursor или Continue искали в них, читали и при желании дополняли. Редактор SoloMD не обязателен.

Пример запроса к агенту

Найди в моих заметках все невыполненные задачи по проекту запуска, сгруппируй их по файлам и покажи, на какие заметки они ссылаются

MCP

Транспорт

stdio, http

Авторизация

не нужна

Ограничения

Всего 16 инструментов, а `export_note` показывается только когда в `PATH` есть `node` и найден скрипт `solomd-export.mjs` (путь задает `SOLOMD_EXPORT_SCRIPT`, или он ищется в клонированном репозитории). В установленном приложении нет ни Node.js, ни этого скрипта.

Все пути приводятся к канонической форме и проверяются на нахождение внутри папки, `..` и абсолютные пути наружу отклоняются. Исключение — `export_note` с ключом `--allow-write`: он пишет вне папки, но не создает каталоги и не заменяет файл без `overwrite: true`.

В режиме HTTP сервер слушает 127.0.0.1:8765. Без `--auth-token` или `SOLOMD_MCP_TOKEN` любой, кто может подключиться к этому адресу, получит заметки. `list_notes` по умолчанию возвращает 100 заметок. Лицензия MIT.

Как отключить. В Claude Code выполните `claude mcp remove solomd-vault -s user`, в Codex удалите раздел `[mcp_servers.solomd-vault]` из `~/.codex/config.toml`. Если сервер ставили скриптом, удалите файл `solomd-mcp` из `/usr/local/bin` или `~/.local/bin`. Чтобы запретить запись, уберите `--allow-write` из аргументов запуска и перезапустите клиент.

Коротко о README

В папке `mcp-server` лежат исходники на Rust, манифест пакета MCPB и подробное описание сервера. Оно идет от запуска и таблицы из 16 инструментов к установке тремя способами, подключению для Claude Code, Codex, Cursor и облачных клиентов, справке по параметрам, правилам безопасности и проверке рукопожатием. Рядом в репозитории лежат настольный редактор на Tauri с переводами README на четырнадцать языков, веб-клиппер и скрипты установки.