convez.ai
MCP ServerEscrita & ConteúdoIntermediário
ofershap

MCP Server Markdown

ofershap/mcp-server-markdown

Busca e navegação inteligente em markdown com extração de seções e código

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para buscar, navegar e extrair conteúdo de arquivos markdown locais. Oferece busca full-text, extração de seções por heading, listagem de índice, descoberta de blocos de código e parsing de frontmatter YAML.

Instalação

$npx convez-ai ofershap/mcp-server-markdown

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
11
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
v1.0.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Indexar e pesquisar wikis internos e bases de conhecimento em markdown
  • Extrair seções específicas de documentação por heading
  • Encontrar exemplos de código por linguagem em repositórios
  • Navegar ADRs (Architecture Decision Records) e guias de onboarding
  • Consultar metadados YAML em documentação estruturada

Veredito

Ferramenta sólida para quem trabalha com documentação em markdown. Preenche uma lacuna real entre leitura de arquivos brutos e navegação semântica, com suporte multi-cliente e zero overhead de autenticação.

README

A tradução para o português deste README ainda está na fila.

mcp-server-markdown

npm version npm downloads CI TypeScript License: MIT

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.

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

ToolWhat it does
list_filesList all .md files in a directory recursively (sorted alphabetically)
search_docsFull-text search across all .md files (case-insensitive, up to 50 results)
get_sectionExtract a section by heading until the next heading of same/higher level
list_headingsList all headings as a table of contents
find_code_blocksFind fenced code blocks, optionally filter by language (e.g. typescript)
get_frontmatterParse YAML frontmatter metadata at the start of a file

Quick Start

Cursor

Add to .cursor/mcp.json:

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

Claude Desktop

Add to claude_desktop_config.json:

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

VS Code

Add to user settings or .vscode/mcp.json:

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

Examples

  • "Search all docs in ./docs for mentions of 'authentication'"
  • "Show me the 'API Reference' section from README.md"
  • "List all headings in CONTRIBUTING.md"
  • "Find all TypeScript code blocks in the docs"
  • "What's the frontmatter metadata in this file?"
  • "Give me the table of contents for our architecture docs"

Development

git clone https://github.com/ofershap/mcp-server-markdown.git
cd mcp-server-markdown
npm install
npm test
npm run build

See also

More MCP servers and developer tools on my portfolio.

Author

Made by ofershap

LinkedIn GitHub


README built with README Builder

License

MIT © 2026 Ofer Shapira

Ver o original no GitHub

Bom para

Relacionados