Local Docs MCP Server  

Implementation of the Model Context Protocol (MCP) server for local documentation access. Provides Claude with seamless access to markdown documentation from multiple sources.

Features

• Multi-source documentation: Access docs from commands, project docs, and project root
• Smart search: Fuzzy matching with exact/substring match priority
• YAML frontmatter support: Optional metadata for enhanced search (description, tags)
• Always-on caching: File list caching with automatic invalidation on changes (~3000x faster)
• File watching: Automatic cache invalidation when documentation files change
• Safe path handling: Prevents directory traversal and validates paths
• Source prefixes: Explicitly specify documentation source (e.g., commands:file.md)
• Size limits: Prevents reading files larger than 5MB

Documentation Sources

1. Shared Docs (~/.claude/commands/**/*.md): User commands and knowledge bases (configurable)
2. Project Docs ($CWD/docs/**/*.md): Project-specific documentation with configurable exclusions
3. Project Root ($CWD/*.md): Root-level docs like README.md (opt-in)

YAML Frontmatter Support

Documentation files can optionally include YAML frontmatter for enhanced searchability:

---
description: Enforce Test-Driven Development approach for Go code with test-first workflow
tags: [testing, development, go]
---

# Your Documentation Content

Supported fields:

• description: Text description used to boost search relevance
• tags: Array or comma-separated list of tags for categorization

Search behavior:

• Description matches add +0.5 to search score
• Exact tag matches add +0.3 to search score
• Partial tag matches add +0.15 to search score
• Frontmatter is automatically stripped from read_doc output
• list_all_docs includes description and tags in file metadata

Note: Frontmatter is completely optional - plain markdown files work perfectly without it.

Installation

Download Binary

Download the latest release from the releases page.

Using Go

go install github.com/umputun/local-docs-mcp/app@latest

Using Homebrew (macOS)

brew tap umputun/apps
brew install umputun/apps/local-docs-mcp

Build from Source

git clone https://github.com/umputun/local-docs-mcp.git
cd local-docs-mcp
make build
make install

Configure Claude

Add to ~/.claude.json:

{
  "mcpServers": {
    "local-docs": {
      "command": "local-docs-mcp"
    }
  }
}

Or use absolute path:

{