read_documentLABSCO SUMMARY
Health checking is what separates this from filesystem access.
Reading and writing Markdown is something a plain filesystem server already does. Assessing missing frontmatter and broken links across the set, and generating navigation from the structure, is the part that treats the folder as documentation rather than as files - and it is the question nobody asks until the docs have already rotted.
What it is
A documentation manager over a directory of Markdown files with YAML frontmatter. It handles the file operations and the metadata, and it can assess the state of the whole set rather than one page at a time.
What you get
- Read and write documents with their frontmatter, and make precise line-based edits
- List and search documents by content or by metadata
- Create folders and sections, and move, rename or delete documents
- A health check across the documentation - missing metadata, broken links and other quality problems
- Link and metadata validation as separate calls when you want just one of those answers
- Navigation generated from the documentation structure, readable and reorderable
- A consolidated single-document view of everything, produced for feeding to a language model
Requirements
Node. Run it with npx mcp-docs-service and the path to your documentation directory, which is the only argument it needs - that path is the boundary of what it can touch. Client configuration is the same shape for Cursor and Claude Desktop; both take an absolute path to the docs folder.
Setup effort
One command — npx mcp-docs-service <YOUR_PATH_TO_DOCS>
USE CASES
Finding out what state the documentation is in
Run the health check across the whole folder and read what it reports before deciding where to spend effort.
Updating a page without rewriting it
Read the document, make line-based edits with a diff preview, and leave the rest of the file alone.
Reorganising a documentation set
Create the sections you need, move and rename documents into them, and regenerate the navigation afterwards.
Handing the whole set to a model
Generate the consolidated knowledge-base document rather than feeding files one by one.
14 tools
Listed in project docs. Your client may show a different list.
list_documentswrite_documentedit_documentsearch_documentsgenerate_documentation_navigationcheck_documentation_healthcreate_documentation_foldermove_documentrename_documentupdate_documentation_navigation_ordercreate_documentation_sectionvalidate_documentation_linksvalidate_documentation_metadataBEFORE YOU INSTALL
What to know first
Tools you get
14 tools named in the project's documentation.
Requires
npm on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
npx mcp-docs-service <YOUR_PATH_TO_DOCS>MCP Clients
Cursor
{
"mcpServers": {
"docs-manager": {
"command": "npx",
"args": [
"-y",
"mcp-docs-service",
"<YOUR_PATH_TO_DOCS>"
]
}
}
}Claude Desktop
{
"mcpServers": {
"docs-manager": {
"command": "npx",
"args": [
"-y",
"mcp-docs-service",
"<YOUR_PATH_TO_DOCS>"
],
"env": {
"MCP_NPX_WRAPPER": "true"
}
}
}
}