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.

Related MCP server: Code Analysis MCP Server

🛠️ Professional Tool Suite (24 Tools)

1. Intelligence & Search 🧠

2. Implementation Integrity ✅

3. Context & Surroundings 🧭

4. Code Quality & Security 🛡️

5. Workspace & Utilities 🏕️

💎 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_docs)

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 (get_context)

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", "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 docsgrep run <tool_name> [--param value]

Examples

# Run a code quality audit on the current directory
npx docsgrep run analyze_code

# Run a security scan and output as JSON
npx docsgrep run audit_security --format json

# Search for a pattern in documentation
npx docsgrep run search_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/reasvyn/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. 🚀