Добавить сервер
ofershap/mcp-server-markdown
  1. Каталог MCP
  2. ofershap/mcp-server-markdown

ofershap/mcp-server-markdown

от ofershap
MCP сервер для поиска и навигации по локальным markdown-файлам: полнотекстовый поиск, извлечение разделов по заголовкам, навигация по оглавлению, поиск блоков кода по языку и парсинг frontmatter. П...
GithubNPMСайт сервера

mcp-server-markdown

npm version npm downloads CI TypeScript License: MIT Agent Plugins

Search, navigate, and extract content from local markdown files. Full-text search, section extraction, heading navigation, code block discovery, and frontmatter parsing.

npx mcp-server-markdown

Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Reads local .md files, no auth needed.

Install in Cursor   Add to VS Code

MCP server for searching and navigating markdown documentation

Demo built with remotion-readme-kit

Why

Tools like Context7 are great for looking up library docs from npm, but they don't help with your own documentation. Project wikis, internal knowledge bases, architecture decision records, onboarding guides: they all live as markdown files in your repo or on disk. The filesystem MCP server can read those files, but it treats them as raw text. It doesn't understand headings, sections, or code blocks. This server does. Point it at a directory and your assistant can search across all your docs, pull out a specific section by heading, list the table of contents, or find every TypeScript code example in your knowledge base.

Tools

Инструменты были проиндексированы:
find_code_blocks

Находит все блоки кода, ограниченные тройными обратными кавычками, в markdown-файле. Опционально фильтрует по языку (например, typescript, python).

Параметры
  • filestringобязательный

    Путь к файлу Markdown

  • languagestring

    Необязательно: фильтровать по языку (например, typescript, python)

get_frontmatter

Разбирает YAML frontmatter (между разделителями ---) в начале markdown-файла. Возвращает метаданные в формате ключ-значение.

Параметры
  • filestringобязательный

    Путь к файлу Markdown

get_section

Извлекает раздел по заголовку из markdown-файла. Возвращает содержимое от этого заголовка до следующего заголовка того же или более высокого уровня.

Параметры
  • filestringобязательный

    Путь к файлу Markdown

  • headingstringобязательный

    Находит текст заголовка (без учёта регистра).

list_files

Выводит список всех .md файлов в директории рекурсивно. Возвращает относительные пути, отсортированные по алфавиту.

Параметры
  • directorystringобязательный

    Путь к каталогу для сканирования (например, ./docs)

list_headings

Выводит все заголовки (от # до ######) в markdown-файле в виде оглавления.

Параметры
  • filestringобязательный

    Путь к файлу Markdown

search_docs

Полнотекстовый поиск по всем .md файлам в директории. Возвращает файл, номер строки и совпадающую строку. Ограничение: до 50 результатов.

Параметры
  • directorystringобязательный

    Путь к каталогу для поиска (например, ./docs)

  • querystringобязательный

    Строка поиска (без учета регистра)

1.0.2основная
1.0.1
1.0.0

Выберите клиент, чтобы установить ofershap/mcp-server-markdown:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "ofershap-mcp-server-markdown-ym2akqyqe1": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "ofershap-mcp-server-markdown-ym2akqyqe1": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "ofershap-mcp-server-markdown-ym2akqyqe1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"ofershap-mcp-server-markdown-ym2akqyqe1\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mcp-server-markdown\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "ofershap-mcp-server-markdown-ym2akqyqe1": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add ofershap-mcp-server-markdown-ym2akqyqe1 -- npx -y mcp-server-markdown

Либо через JSON-конфиг:

claude mcp add-json ofershap-mcp-server-markdown-ym2akqyqe1 "{\"command\":\"npx\",\"args\":[\"-y\",\"mcp-server-markdown\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add ofershap-mcp-server-markdown-ym2akqyqe1 -- npx -y mcp-server-markdown

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.ofershap-mcp-server-markdown-ym2akqyqe1]
command = "npx"
args = ["-y", "mcp-server-markdown"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите ofershap/mcp-server-markdown, а в поле команды запуска — строку ниже:
npx -y mcp-server-markdown

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ofershap-mcp-server-markdown-ym2akqyqe1": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "ofershap-mcp-server-markdown-ym2akqyqe1": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например ofershap-mcp-server-markdown-ym2akqyqe1.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: ofershap-mcp-server-markdown-ym2akqyqe1
    command: npx
    args:
      - "-y"
      - "mcp-server-markdown"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "ofershap-mcp-server-markdown-ym2akqyqe1": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ]
    }
  }
}

Похожие MCP-сервера

Kapeli/dash-mcp-server

Kapeli/dash-mcp-server

от kapeli

MCP сервер для работы с Dash - браузером документации для macOS. Позволяет AI-ассистентам искать в docsets, загружать страницы документации и включать полнотекстовый поиск. Полезен разработчикам, и...

Python⭐ 186
vivekvells/mcp-pandoc

vivekvells/mcp-pandoc

от vivekvells

Конвертирует документы между Markdown, PDF, DOCX и другими через Pandoc. Работает с файлами и текстом, сохраняет оформление.

Python⭐ 583
mrjoshuak/godoc-mcp

mrjoshuak/godoc-mcp

от mrjoshuak

MCP-сервер для быстрого доступа к документации Go-пакетов. Он помогает LLM понимать код без чтения целых файлов, экономя токены. Полезен Go-разработчикам, использующим ИИ-ассистентов.

Go⭐ 125
laradji/deadzone

laradji/deadzone

от laradji

Deadzone — векторный индекс для семантического поиска по документации, работающий как локальный MCP-сервер. Полезен разработчикам AI-агентов, которым нужен поиск по документам без интернета. Исполь...

Go⭐ 4
izzzzzi/codewiki-mcp

izzzzzi/codewiki-mcp

от izzzzzi

Сервер MCP для codewiki.google — поиск репозиториев, получение подробной документации и ответы на вопросы на естественном языке. Подключает AI к вики-страницам любых open-source проектов.

TypeScript⭐ 18
Context7 MCP

Context7 MCP

официальный

от upstash

Находит свежую документацию и примеры кода для любых библиотек, подтягивает нужные фрагменты с учётом версии. Без выдуманных API из старых данных.

TypeScript⭐ 63337
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин