Documentation Manager MCP server

MCP Documentation Service is a Model Context Protocol implementation for documentation management. It provides tools for reading, writing, and managing markdown documentation with frontmatter metadata, designed to work seamlessly with AI assistants like Claude in Cursor or Claude Desktop, enabling easy documentation management through natural language interactions.

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

Integration Options

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 from Claude's website

2. Configure Claude Desktop for MCP:

   • Open Claude Desktop
   • Click on the Claude menu and select "Developer Settings"
   • This creates 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"]
    }
  }
}

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 - You should see a green dot for docs-manager MCP tool

6. Troubleshooting:

   • Check logs at:
     • macOS: ~/Library/Logs/Claude/mcp*.log
     • Windows: %APPDATA%\Claude\logs\mcp*.log
   • Ensure Node.js is installed
   • Make sure paths in your configuration are absolute and valid

Using the Service

With Claude in Cursor

You can invoke the tools in two ways:

1. Using Natural Language (Recommended):
   • Ask Claude to perform tasks 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:

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

@docs-manager mcp_docs_manager_list_documents recursive=true

@docs-manager mcp_docs_manager_check_documentation_health

With Claude Desktop

1. Using Natural Language (Recommended):

Can you read the README.md file for me?

Please find all documents that mention "API" in my documentation.

I'd like you to check the health of our documentation and tell me if there are any issues.

2. Using the Tool Picker:
   • Click the hammer icon in the bottom right corner of the input box
   • Select "docs-manager" from the available tools
   • Choose the specific tool you want to use
   • Fill in the required parameters and click "Run"

Common Commands

Reading a Document

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

Writing a Document

@docs-manager mcp_docs_manager_write_document path=docs/new-document.md content="---
title: New Document
description: A new document created with MCP Docs Service
---

# New Document

This is a new document created with MCP Docs Service."

Editing a Document

@docs-manager mcp_docs_manager_edit_document path=README.md edits=[{"oldText":"# Documentation", "newText":"# Project Documentation"}]

Searching Documents

@docs-manager mcp_docs_manager_search_documents query="getting started"

Generating Navigation

@docs-manager mcp_docs_manager_generate_navigation

Advanced Features

Documentation Health Check

You can check the health of your documentation with:

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

The health score is based on:

• Completeness of metadata
• Presence of broken links
• Orphaned documents
• Consistent formatting and style

Consolidated Documentation for LLMs

Generate a consolidated documentation file optimized for large language models:

# With default filename (consolidated-docs.md)
npx mcp-docs-service --single-doc /path/to/docs

# With custom output filename
npx mcp-docs-service --single-doc --output my-project-context.md /path/to/docs

# With token limit
npx mcp-docs-service --single-doc --max-tokens 100000 /path/to/docs

The consolidated output includes:

• Project metadata
• Table of contents with token counts
• All documentation organized by section
• Token counting to help stay within LLM context limits

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

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

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect