# mcp-md-reader

Плагин mcp-md-reader для Claude Code и Codex находит нужные разделы Markdown и читает их выборочно. Помогает работать с большими файлами и хранилищами заметок.

- плагин · `type=plugin` · Claude Code, Codex · ★ 1596 у репозитория
- Автор: Jose Estévez
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/JoseEstevez520/mcp-md-reader
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 3 файла скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/mcp-md-reader

## Что делает

mcp-md-reader сначала строит компактное дерево заголовков, а затем возвращает выбранный раздел, YAML frontmatter или подходящие области документов. `md_find` ищет по индексу хранилища, `md_tree` показывает структуру и оценку токенов, `md_section` открывает раздел, а `md_vault_index` помогает изучать связи между заметками.

Внутри плагина есть MCP-сервер на TypeScript и Node.js, разбор Markdown с учётом блоков кода, кэш в памяти и на диске, а также граф хранилища с обновлением устаревшего индекса. Для запуска нужен Node.js 18 или новее. Плагин для Codex содержит манифест и собранный MCP-исполняемый файл.

Сервер работает с правами локальной учётной записи, поэтому доверенный MCP-клиент сможет запросить любой Markdown-файл, доступный этой учётной записи. Для строгой границы доступа нужен отдельный системный аккаунт или такие же ограничения файловой системы.

## Установка

### Claude Code (родная платформа)

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
В чате агента (не в терминале):
```text
/plugin install mcp-md-reader@awesome-codex-plugins
```

## Когда брать
- найти нужный раздел в хранилище Markdown
- получить дерево заголовков без чтения всего файла
- извлечь YAML frontmatter отдельно
- проследить связи между заметками в vault
- открыть раздел по неточному заголовку

## Примеры запросов агенту
- Найди в хранилище разделы о многоарендной безопасности через `md_find`, затем открой подходящий результат.
- Покажи структуру файла `notes/project.md` с помощью `md_tree`.
- Получи раздел «Decisions» из `notes/project.md` через `md_section`.

## Похожие
- [obsidian](https://affpapa.org/nevibecode/skills/teknium-teknium1-hermes-agent-obsidian.md) — скилл · 503 установки
- [nature-reader](https://affpapa.org/nevibecode/skills/nature-reader.md) — скилл · 16600 установок
- [twitter-reader](https://affpapa.org/nevibecode/skills/twitter-reader.md) — скилл · 3400 установок
- [oh-my-obsidian](https://affpapa.org/nevibecode/plugins/oh-my-obsidian.md) — плагин · ★ 31 у репозитория
- [obsidian-log](https://affpapa.org/nevibecode/commands/obsidian-log.md) — команда · ★ 5412 у репозитория
- [swarmvault](https://affpapa.org/nevibecode/skills/swarmclawai-swarmvault.md) — скилл · ★ 710 у репозитория

Из того же набора: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
