К основному содержанию
плагин CX Codex

mcp-md-reader — плагин Claude Code: установка и возможности

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

Apache-2.0 ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install mcp-md-reader@awesome-codex-plugins
Открыть на GitHub

Что делает 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-файл, доступный этой учётной записи. Для строгой границы доступа нужен отдельный системный аккаунт или такие же ограничения файловой системы.

Какие задачи решает

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

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

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

Как установить mcp-md-reader

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install mcp-md-reader@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о mcp-md-reader

Как установить mcp-md-reader в Claude Code?

Выполните /plugin marketplace add hashgraph-online/awesome-codex-plugins и затем /plugin install mcp-md-reader@awesome-codex-plugins.

Что делает mcp-md-reader?

Плагин помогает агенту ориентироваться в больших Markdown-файлах и vault-хранилищах. Он возвращает структуру, выбранный раздел, frontmatter или данные о связях вместо полного документа.

Какие ограничения доступа есть у mcp-md-reader?

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

Исходный текст

mcp-md-reader · Apache-2.0
<p align="center">
  <img src="assets/readme-hero.png" alt="Read only what you need" width="100%" />
</p>

<p align="center">
  <img src="https://img.shields.io/badge/MCP-compatible-57a8ff" alt="MCP compatible" />
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-55e2cc" alt="Apache 2.0 license" /></a>
  <img src="https://img.shields.io/badge/node-%E2%89%A518-3c873a" alt="Node.js 18 or later" />
  <a href="https://github.com/hashgraph-online/hol-guard"><img src="https://img.shields.io/badge/HOL%20Guard-passing-00a67e" alt="HOL Guard Scanner" /></a>
</p>

<p align="center"><strong>Intelligent Markdown reading for MCP clients.</strong></p>

**mcp-md-reader** helps AI agents navigate large Markdown files and vaults without paying the context cost of reading everything. It returns a compact structure first, then only the precise section, metadata, or graph information the agent needs.

## Used in SkillNet

[SkillNet](https://github.com/ANFAIA/SkillNet) uses mcp-md-reader in its post-Markdown research:
agents can inspect the structure of company documentation and retrieve only the sections needed
for course generation. The reader remains a standalone MCP server; SkillNet is a consumer and
validation context, not a required runtime dependency.

| Smaller context | Deterministic retrieval | Vault-aware |
| :--- | :--- | :--- |
| Read the relevant section instead of a whole 3,000-token document. | Fuzzy structural matching—no embeddings and no LLM calls. | Search, index, and traverse relationships across a Markdown vault. |

> Start with `md_find` for a vault-wide question, then open the selected result with `md_section`.

## Why it matters

A 3,000-token file with 12 sections may only contain one relevant 300-token answer. Without a structural reader, an agent reads all 3,000 tokens. With this server, it can inspect a compact tree first and retrieve only the needed section. The exact reduction depends on the document and selected section.

```text
large Markdown file
        │
        ├── md_find / md_tree  → identify the relevant destination
        ├── md_section         → retrieve only that section
        └── md_vault_index     → explore connections across the vault
```

## MCP tools

| Tool | What it does | Typical saving |
| :--- | :--- | :---: |
| `md_find` | Finds relevant sections across a vault and ranks them. | — |
| `md_tree` | Returns a heading tree with token estimates. | ~93% |
| `md_section` | Retrieves a fuzzy-matched section. | ~88–99% |
| `md_frontmatter` | Returns YAML frontmatter only. | ~99% |
| `md_vault_index` | Queries the compiled graph of the entire vault. | — |

## Setup

```bash
git clone https://github.com/JoseEstevez520/mcp-md-reader.git
cd mcp-md-reader
npm install
npm run build
```

Register it with an MCP client such as Claude Code:

```bash
claude mcp add md-reader -- node /full/path/to/mcp-md-reader/dist/index.js
```

Restart the client and the five tools will be available natively.

### Codex plugin

The repository also contains a Codex plugin manifest and a bundled MCP executable. The bundle is
generated from `src/index.ts`, contains its runtime dependencies, and is smoke-tested against the
five exposed tools:

```bash
npm run bundle:plugin
npm test
```

The plugin entry point is `.codex-plugin/plugin.json`; its bundled server configuration is in
`.mcp.json`.

## Example

```text
> md_tree("notes/project.md")

File: notes/project.md
Full file: ~2428 tokens
This tree: ~84 tokens
Savings: ~97%
# Project
  ## Objective
  ## Current state
  ## Decisions

> md_section("notes/project.md", "Decisions")

Section: Decisions
Section tokens: ~297 | Full file: ~2428 | Savings: ~88%
```

## Search a vault with `md_find`

`md_find` is the front door for broad questions. It searches a compiled index using deterministic title, tag, filename, substring, shared-prefix, acronym, and CamelCase matching. The result contains only matching document regions—not the full vault—and tells the client which section to open next.

```text
> md_find({vault_path: "/path/to/vault", query: "row level security multi-tenant"})

Found 2 matching document(s).
Read a section → md_section(path, heading)
/path/to/vault/base_de_datos/postgres.md
  · Postgres › Row Level Security
```

## Explore relationships with `md_vault_index`

The vault index compiles Markdown files into a graph and refreshes when stale. Query stats, a node, neighbors, a shortest path, nodes by type, the most connected hubs, or isolated notes.

| Query | Purpose |
| :--- | :--- |
| `stats` | Total nodes, edges, and types. |
| `node` / `neighbors` | Inspect a note and its local graph. |
| `path` | Find the shortest connection between two notes. |
| `search_type` | List notes of a frontmatter type. |
| `most_connected` / `isolated` | Find hubs and orphaned notes. |

## Under the hood

- TypeScript + Node.js with the MCP SDK over stdio.
- Pure, code-block-aware string parsing—no external parser dependency.
- LRU memory cache plus persistent disk cache with mtime validation.
- Fuzzy heading matching for exact, prefix, word-boundary, acronym, and CamelCase queries.
- Vault graph traversal with automatic recompilation when the index is stale.

## Security and filesystem scope

The server runs locally with the filesystem permissions of the account that starts it. Tool calls
accept file and vault paths, so a trusted MCP client can request any Markdown file readable by that
account. Use a dedicated operating system account or equivalent filesystem controls when a stricter
boundary is required. Parsed documents may be cached in the operating system temporary directory.
See [SECURITY.md](SECURITY.md) for reporting and cache details.

## Reproducible tests and benchmark

```bash
npm ci
npm test
npm run benchmark
```

The default benchmark uses only the public corpus in `test/fixtures`. To measure another corpus,
set `MD_READER_BENCHMARK_DIR` to its directory before running the command. Token counts use
`ceil(characters / 4)`, not a model tokenizer, and every reported saving applies only to the corpus
that was measured.

For release history and benchmark details, see [CHANGELOG.md](CHANGELOG.md).

## License

[Apache License 2.0](LICENSE)

© Jose Estévez · Apache-2.0 · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
obsidian Teknium (teknium1), Hermes Agent Читает, ищет, создаёт и редактирует заметки в хранилище Obsidian. CX Codex +1 503установок nature-reader Community contribution, refactored into static/dynamic layers Скилл nature-reader создаёт двуязычные китайско-английские ридеры научных статей с разметкой текста, таблиц и формул. Помогает разобрать публикацию целиком или ответить на точечный вопрос по источнику. CX Codex +1 16 600установок twitter-reader daymade Скилл twitter-reader для Claude Code выгружает посты и статьи из Twitter/X в Markdown с метаданными и скачанными картинками. Сохраняет архивы в базу знаний. CX Codex +1 3 400установок oh-my-obsidian hongdangmoo49 Плагин oh-my-obsidian даёт Claude Code постоянную память через хранилище Obsidian: агент записывает решения и контекст сессий в Markdown, а потом находит нужное через поиск по хранилищу. ★ 31звёзд репо obsidian-log Eugeniu Ghelbur Команда obsidian-log записывает итоги текущей сессии разработки в базу Obsidian. Команда сама определяет проект по контексту диалога и форматирует заметку для будущих агентов. CX Codex +1 ★ 5 412звёзд репо swarmvault swarmclawai Задаёт правила работы с базой знаний SwarmVault через граф и компилятор — структурирует документы и связывает факты без слепого поиска по файлам. CX Codex +1 ★ 710звёзд репо

Из того же набора391

Весь набор →
multi-llm Плагин multi-llm для Claude Code и Codex параллельно проверяет планы, код и коммиты через 19 консольных ИИ-инструментов, проверяет замечания и готовит задачи для правок. CX Codex ★ 1 596звёзд репо ml-pipeline Плагин ml-pipeline проводит ML-задачу через строгий 16-шаговый процесс: от проверки данных до оценки модели. Он нужен, когда агент начинает обучение слишком рано. CX Codex ★ 1 596звёзд репо memoire Плагин memoire даёт агенту память о вашей дизайн-системе: проверяет интерфейс, достаёт токены Tailwind из готовой вёрстки и ведёт работу с реестром shadcn. CX Codex ★ 1 596звёзд репо codex-multiple-env Плагин codex-multiple-env изолирует профили аккаунтов и воркспейсов ChatGPT для Codex CLI в каталогах CODEX_HOME. Позволяет переключать учётные записи без постоянного выхода из системы. CX Codex ★ 1 596звёзд репо mailagent Плагин mailagent даёт агенту временные почтовые ящики: принять письмо с кодом или magic link, проверить регистрацию и удалить инбокс. CX Codex ★ 1 596звёзд репо magents Плагин magents связывает сессии Codex, Claude и Cursor через общую шину MCP. Помогает передавать контекст и запускать задачи без ручного копирования. CX Codex ★ 1 596звёзд репо maestro Плагин maestro для Claude Code отправляет один запрос нескольким локальным CLI-моделям, поручает выбранной модели-судье сравнить ответы, а синтезатору — собрать общий итог. CX Codex ★ 1 596звёзд репо lvtd-skills Плагин lvtd-skills для Claude Code и Codex собирает готовые скиллы по Django, htmx, Rust, документации, SEO, тракшену и книгам — по одному файлу SKILL.md на тему. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой