This Model Context Protocol (MCP) server provides Markdown utilities for “search, extract sections, list headings, [and] find code blocks.” It is packaged as io.github.ofershap/markdown and is described as “Markdown MCP” in the repository excerpt. Topics include AI, Claude, Cursor, LLM, TypeScript, and MCP.
🛠️ Key Features
Search Markdown content
Extract sections
List headings
Find code blocks
🚀 Use Cases
Locate specific sections in Markdown documents
Build tooling around heading structure
Extract code blocks for downstream processing
⚡ Developer Benefits
Supports common Markdown parsing tasks via MCP
Integrates with Model Context Protocol workflows
Implemented in TypeScript (strict noted in excerpt)
⚠️ Limitations
Only Markdown-focused operations are described (no other formats or capabilities indicated)
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
Tool
What it does
list_files
List all .md files in a directory recursively (sorted alphabetically)
search_docs
Full-text search across all .md files (case-insensitive, up to 50 results)
get_section
Extract a section by heading until the next heading of same/higher level
list_headings
List all headings as a table of contents
find_code_blocks
Find fenced code blocks, optionally filter by language (e.g. typescript)
get_frontmatter
Parse YAML frontmatter metadata at the start of a file
"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"
Agent Plugins
This repo is an Agent Plugins 1.0.0 package: plugin.json, portable mcp.json, and skills/ ship together with the MCP server.
For Cursor, clone the repo and copy or symlink it to ~/.cursor/plugins/local/mcp-server-markdown, then reload the window. Skills and MCP show up under Customize > Plugins.
The Cursor and VS Code install buttons above still work: they add the same npx -y mcp-server-markdown stdio server as manual JSON.
FAQ
What is mcp-server-markdown?
An MCP server that searches and navigates local .md files: full-text search, sections by heading, TOC, code blocks, and YAML frontmatter.
How is this different from Context7?
Context7 pulls published library docs from npm. This server indexes markdown already on your disk (wikis, ADRs, internal guides).
How is this different from the filesystem MCP?
Filesystem tools read raw files. This server understands headings, sections, fenced code, and frontmatter.
Can I install it as an Agent Plugin in Cursor?
Yes. Use ~/.cursor/plugins/local/mcp-server-markdown so the bundled markdown-search skill loads with the MCP config.
Do I need API keys?
No. Paths are local; the agent passes directory and file paths to the tools.
Development
bash
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.
