markdown-lsp-mcp

Local MCP server (over stdio) that exposes markdown-lsp tools — outline, fuzzy search, full-text search, link graph — for any local docs/ directory.

Designed to be used by AI agents (Claude Code, Cursor) to navigate a project's markdown documentation without uploading anything to the network. No database, no daemon — just stdio.

Quick start

npx markdown-lsp-mcp --docs ./docs

Then connect from any MCP client over stdio.

Tools

| Tool | Purpose | |---|---| | doc_outline | Heading outline of one page | | doc_workspace_outline | List all pages with titles + heading counts | | doc_search_text | Full-text search across the docs | | doc_search_symbols | Fuzzy search across headings (LSP workspace/symbol) | | doc_search_links_to | Find pages that link to a given page (references) | | doc_search_links_from | Find outgoing links from a page | | doc_resolve_link | Resolve a wiki-link or relative link to a real page | | doc_get_section | Body content of a specific section by anchor | | doc_search_paths | Glob match on page paths |

Use in Claude Code

Add to .mcp.json in your repo root:

{
  "mcpServers": {
    "markdown-lsp": {
      "command": "npx",
      "args": ["-y", "markdown-lsp-mcp", "--docs", "./docs"]
    }
  }
}

Used by

This package powers the docs-sync skill — a pre-push git hook that detects and fixes code↔docs drift in parallel git worktrees before push.

Development

pnpm install
pnpm build
pnpm test

License

MIT