@anovise/docsgrep

docsgrep is a high-performance Model Context Protocol (MCP) Server that empowers developers and AI agents to master complex codebases through intelligent documentation search, proactive bug detection, and semantic analysis.

🚀 The Vision

Modern codebases are massive, but documentation is often fragmented or stale. docsgrep is the bridge. It doesn't just search text; it understands project structure, import relationships, and implementation truth.

🛠️ Professional Tool Suite (24 Tools)

1. Intelligence & Search 🧠

| Tool | Description | |---|---| | fathom_meaning | Semantic Search: Understands natural language queries to find docs. | | grep_docs | Contextual Grep: Search with relevance ranking and contextLines. | | hunt_related | Topic Discovery: Finds docs matching specific themes or concepts. | | tldr_docs | Auto-Summary: Summarizes long docs into digestible bites. |

2. Implementation Integrity ✅

| Tool | Description | |---|---| | verify_truth | Signature Validation: Checks if documented functions match the code. | | gauge_docs | Docblock Coverage: Measures how much of the code is documented. | | catch_bugs | Bug Catcher: Finds logic flaws with smart noise reduction. | | spot_delta | Delta Analysis: Compares documentation claims against reality. | | smell_stale | Staleness Detection: Identifies docs that are outdated or out of sync. |

3. Context & Surroundings 🧭

| Tool | Description | |---|---| | sense_surroundings | Radar: Finds docs based on imports and file proximity. | | catch_fossils | Git-Aware: Prioritizes doc updates based on recent code commits. | | spy_stack | Stack Analysis: Identifies the project's tech stack and lock files. | | sniff_style | Style Sniffer: Detects coding conventions and implicit patterns. |

4. Code Quality & Security 🛡️

| Tool | Description | |---|---| | lint_code | Enterprise Audit: Comprehensive quality and documentation scoring. | | guard_security | Security Guard: OWASP Top 10, Secrets, PII, and Dependency scans. | | ask_lint / ask_guard | Interactive Prompts: Targeted auditing via guided selection. |

5. Workspace & Utilities 🏕️

| Tool | Description | |---|---| | setup_camp | Initializes a secure workspace for temp files and reports. | | fetch_repo | Clones remote repos with smart caching and branch support. | | peek_file | Reads files with binary protection and large-file streaming. | | doc_the_tools | Self-documenting help system with examples and pro-tips. |

💎 Key Feature Highlights

🐛 Smart Bug Detection (catch_bugs)

Engineered for accuracy. It doesn't just flag patterns; it understands context.

• Try-Catch Awareness: Doesn't complain about await if you've handled it.
• Test-File Logic: Lowers severity for issues in test files to keep focus on production.

✅ Signature Validation (verify_truth)

Documentation rot is a thing of the past.

• Arity Check: Validates that documented functions have the correct number of parameters.
• Existence Check: Ensures every documented symbol actually exists in the code.

🧭 Autonomous Radar (sense_surroundings)

The perfect companion for AI Agents.

• Dependency Tracking: Reads your import statements to suggest relevant docs.
• Hierarchical Context: Understands README importance and directory relationships.

🎯 Surgical Scope Control

All scanning tools now support advanced filtering:

• includePath: Target specific modules or files (e.g., ["src/auth/**"]).
• excludePath: Skip irrelevant noise, merged with your project's .gitignore.
• Recursive Globbing: Full support for standard glob patterns.

💻 Hybrid Mode (MCP + CLI)

docsgrep is both an automated MCP server and a manual developer tool.

• Human-Readable Output: Beautifully formatted terminal reports by default.
• Easy Integration: Run audits directly via npm scripts or npx.

📦 Installation

Add docsgrep to your MCP client (e.g., Claude Desktop, Cursor):

{
  "mcpServers": {
    "docsgrep": {
      "command": "npx",
      "args": ["-y", "@anovise/docsgrep"]
    }
  }
}

💻 Manual CLI Mode

Beyond MCP, you can run docsgrep manually in your terminal. This is perfect for local audits before committing code.

Usage

npx @anovise/docsgrep run <tool_name> [--param value]

Examples

# Run a code quality audit on the current directory
npx @anovise/docsgrep run lint_code

# Run a security scan and output as JSON
npx @anovise/docsgrep run guard_security --format json

# Search for a pattern in documentation
npx @anovise/docsgrep run grep_docs --pattern "authentication" --contextLines 2

Pre-configured npm Scripts

If installed locally, you can use these shortcuts:

• npm run lint: Quality audit.
• npm run audit: Security audit.
• npm run bugs: Bug detection.
• npm run docs:check: Documentation coverage.

🛠️ Developer Setup

# Clone the repository
git clone https://github.com/anovise/docsgrep.git
cd docsgrep

# Install and Build
npm install
npm run build

# Run Tests (Strict TS & ESM)
npm test
npm run test:coverage

🔒 Security

• Safe Pathing: All file operations are resolved against strict base paths.
• Credential Protection: PII and Secrets are detected but never leaked or logged.
• Resource Limiting: Built-in concurrency limiter prevents system saturation.

📜 License

MIT License. See LICENSE for details.

Built with ❤️ for the AI-Native Engineering Era. 🚀