MCP server for markdown — search, extract sections, list headings, find code blocks
概览
Search, navigate, and extract content from local markdown files. Full-text search, section extraction, heading navigation, code block discovery, and frontmatter parsing. Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Reads local .md files, no auth needed. 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. Add to user settings or .vscode/mcp.json: - "Search all docs in .
README
以下为原文 README 节选，完整内容请查看原文。
mcp-server-markdown
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
.mdfiles, no auth needed.
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
| 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 |
安装
npx -y mcp-server-markdown配置
{
"mcpServers": {
"markdown": {
"command": "npx",
"args": ["-y", "mcp-server-markdown"]
}
}
}