mgrandau/docscope-mcp

docscope-mcp

Model Context Protocol (MCP) server that analyzes code to assess documentation quality and prioritize doc improvements.

Installation

pip install git+https://github.com/mgrandau/docscope-mcp.git

Then configure VS Code to use the MCP server:

docscope-mcp install

This adds the server to .vscode/mcp.json in your current workspace. Reload VS Code to activate.

Workspace installs also copy:

• Prompts → .github/prompts/ (AI prompt templates for code analysis)
• Utils → utils/ (batch analysis scripts)

Global Install (Optional)

To install globally for all VS Code workspaces:

# VS Code (stable)
docscope-mcp install --global

# VS Code Insiders
docscope-mcp install --global --insiders

Usage

MCP Server (VS Code Copilot)

Once installed, the analyze_functions MCP tool is available in VS Code Copilot and other MCP-compatible clients.

CLI Analysis

Analyze source files directly from the command line, useful for CI/CD pipelines, scripts, and terminal-based workflows:

# Analyze a single file
docscope-mcp analyze src/main.py

# Analyze multiple files
docscope-mcp analyze src/*.py

# JSON output for pipelines
docscope-mcp analyze src/main.py --format json

# Analyze inline code (requires --language)
docscope-mcp analyze --code "def foo(): pass" --language python

# Short flags
docscope-mcp analyze -c "def foo(): pass" -l python -f json

Supported languages: python, csharp, vb, vb6, c_cpp

Uninstall

# Workspace
docscope-mcp uninstall

# Global (stable)
docscope-mcp uninstall --global

# Global (Insiders)
docscope-mcp uninstall --global --insiders

Architecture Documentation

For AI-readable architectural contracts and detailed component documentation:

💬 Community

💬 Join the Discord community