mcp-server-markdown 是一个 MCP（Model Context Protocol）服务器，专门用于搜索、导航和提取本地 Markdown 文件的内容。它的核心目标是把磁盘上的 .md 文档变成助手可以结构化理解的数据，而不仅仅是原始文本。
【用途】 项目 wiki、内部知识库、架构决策记录（ADR）、入门指南等文档通常以 Markdown 文件形式存放在仓库或磁盘中。文件系统 MCP 虽然能读取这些文件，但把它们当作纯文本处理，不理解标题、章节或代码块。mcp-server-markdown 则能识别这些结构，让助手可以跨所有文档搜索、按标题提取特定章节、列出目录，或找出知识库中的全部 TypeScript 代码示例。作者也将其与 Context7 做了区分：Context7 用于从 npm 查找已发布的库文档，而本服务器索引的是已经存在于磁盘上的 Markdown 文档。
【主要能力】
- 全文搜索：在指定目录下的 Markdown 文件中进行全文本搜索。
- 章节提取：按标题提取特定章节。
- 标题导航：列出文件中的全部标题，生成目录（TOC）。
- 代码块发现：查找文档中的代码块，例如找出所有 TypeScript 代码块。
- frontmatter 解析：读取文件的 YAML frontmatter 元数据。
【使用方式】 本服务器可作为 MCP 服务器接入 Claude Desktop、Cursor、VS Code Copilot 以及任意 MCP 客户端。安装方式包括在 .cursor/mcp.json、claude_desktop_config.json 或用户设置与 .vscode/mcp.json 中添加配置。它运行的是 npx -y mcp-server-markdown stdio 服务器。该仓库同时是 Agent Plugins 1.0.0 包，包含 plugin.json、可移植的 mcp.json 和 skills/。对于 Cursor，可以克隆仓库并复制或符号链接到 ~/.cursor/plugins/local/mcp-server-markdown，然后重新加载窗口，技能和 MCP 会显示在 Customize > Plugins 下。使用示例包括：搜索 ./docs 下所有文档中关于 authentication 的内容、显示 README.md 中的 API Reference 章节、列出 CONTRIBUTING.md 的所有标题、在文档中查找所有 TypeScript 代码块、查看文件的 frontmatter 元数据，或获取架构文档的目录。
【适用场景】 适合需要让 AI 助手理解并检索本地 Markdown 文档集合的用户，例如开发者查阅仓库内文档、维护内部知识库、处理架构决策记录和入门指南等。
【限制】 不需要 API 密钥，路径为本地路径，由代理向工具传递目录和文件路径。关于收费、价格、平台支持范围、具体效果等未在资料中提供。
