MCP Documentation Service

What is it?

MCP Documentation Service is a Model Context Protocol (MCP) implementation for documentation management. It provides a set of tools for reading, writing, and managing markdown documentation with frontmatter metadata. The service is designed to work seamlessly with AI assistants like Claude in Cursor or Claude Desktop, making it easy to manage your documentation through natural language interactions.

Features

• Read and Write Documents: Easily read and write markdown documents with frontmatter metadata
• Edit Documents: Make precise line-based edits to documents with diff previews
• List and Search: Find documents by content or metadata
• Navigation Generation: Create navigation structures from your documentation
• Health Checks: Analyze documentation quality and identify issues like missing metadata or broken links
• LLM-Optimized Documentation: Generate consolidated single-document output optimized for large language models
• MCP Integration: Seamless integration with the Model Context Protocol
• Frontmatter Support: Full support for YAML frontmatter in markdown documents
• Markdown Compatibility: Works with standard markdown files

Quick Start

Installation

Requires Node to be installed on your machine.

npm install -g mcp-docs-service

Or use directly with npx:

npx mcp-docs-service /path/to/docs

Cursor Integration

To use with Cursor, create a .cursor/mcp.json file in your project root:

{
  "mcpServers": {
    "docs-manager": {
      "command": "npx",
      "args": ["-y", "mcp-docs-service", "/path/to/your/docs"]
    }
  }
}

Claude Desktop Integration

To use MCP Docs Service with Claude Desktop:

1. Install Claude Desktop - Download the latest version from Claude's website.

2. Configure Claude Desktop for MCP:

   • Open Claude Desktop
   • Click on the Claude menu and select "Developer Settings"
   • This will create a configuration file at:
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Edit the configuration file to add the MCP Docs Service:

{
  "mcpServers": {
    "docs-manager": {
      "command": "npx",
      "args": ["-y", "mcp-docs-service", "/path/to/your/docs"]
      "env": {
        "MCP_NPX_WRAPPER": true
      }
    }
  }
}

Make sure to replace /path/to/your/docs with the absolute path to your documentation directory.

4. Restart Claude Desktop completely.

5. Verify the tool is available - After restarting, you should see a green dot for docs-manager MCP tool (Cursor Settings > MCP)

6. Troubleshooting:

   • If the server doesn't appear, check the logs at:
     • macOS: ~/Library/Logs/Claude/mcp*.log
     • Windows: %APPDATA%\Claude\logs\mcp*.log
   • Ensure Node.js is installed on your system
   • Make sure the paths in your configuration are absolute and valid

Examples

Using with Claude in Cursor

When using Claude in Cursor, you can invoke the tools in two ways:

1. Using Natural Language (Recommended):
   • Simply ask Claude to perform the task in plain English:

Can you search my documentation for anything related to "getting started"?

Please list all the markdown files in my docs directory.

Could you check if there are any issues with my documentation?

2. Using Direct Tool Syntax:
   • For more precise control, you can use the direct tool syntax:

@docs-manager mcp_docs_manager_read_document path=docs/getting-started.md

@docs-manager mcp_docs_man

... [View full README on GitHub](https://github.com/alekspetrov/mcp-docs-service#readme)