ofershap avatar

Markdown

ofershap/mcp-server-markdown

Point this at a directory of markdown files and you get six tools: full-text search across all docs, section extraction by heading name, table of contents listing, code block discovery with optional language filtering, and frontmatter parsing. It's built for the markdown that lives in your repo but doesn't get indexed anywhere: ADRs, internal wikis, onboarding guides, architecture notes. The filesystem server reads these as plain text, but this one understands structure. Search returns up to 50 results, section extraction stops at the next same-level heading, and code block queries let you filter by language. Works over stdio with npx, no authentication required.

GitHub stars
3
tool
1
transport
STDIO
last updated
Mar 10, 2026

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

to-markdownGenerate markdown description for files including PDF (.pdf), Images (.jpeg, .jpg, .png, .webp, .svg), HTML (.html), XML (.xml), Microsoft Office (.xlsx, .xlsm, .xlsb, .xls, .et), Open Document Format (.ods), CSV (.csv), and Apple Documents (.numbers)1 params

Generate markdown description for files including PDF (.pdf), Images (.jpeg, .jpg, .png, .webp, .svg), HTML (.html), XML (.xml), Microsoft Office (.xlsx, .xlsm, .xlsb, .xls, .et), Open Document Format (.ods), CSV (.csv), and Apple Documents (.numbers)

Parameters* required
filePathsarray
Array of absolute file paths to generate descriptions for

Sponsors

Readme

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.


View the full README on GitHub

Details

Repository
github.com/ofershap/mcp-server-markdown
Categories
Documents & Knowledge, Search & Web Crawling
Package
mcp-server-markdown
Transport
STDIO
Registry
MCP registry, active

More from ofershap

Related Documents & Knowledge MCP servers

View all
1mlorentedev avatarPDF Modifiermlorentedev/pdf-modifier-mcpModify PDF text, replace with regex, and analyze layout while preserving fonts.3stars
2stonematt avatarMcp Obsidian Clistonematt/mcp-obsidian-cliSave chat notes from Claude Desktop to your vault — MCP on Obsidian CLI. Keep what matters.2stars
3punic-pillars avatarProject Knowledge Mcppunic-pillars/project-knowledge-mcpCross-project knowledge graph for MCP — map features across mobile, backend, and admin codebases.1stars
4zcsabbagh avatarKnowledge Graph Mcpzcsabbagh/knowledge-graph-mcpKnowledge graph MCP for student learning with spaced repetition and mastery tracking1stars
5pocketdrives avatarPocket Drivesai.pocketdrives/pocket-drivesPeer-to-peer car rental search — luxury, exotic, and EV vehicles with delivery across the US.0stars
6michael-kanda avatardesignare.at Knowledgemichael-kanda/designareLesender Zugriff auf Profil, Projekte und Fachwissen von Michael Kanda (designare.at, Web & KI).0stars