Skip to content
MCP server

SnapDoczilla

Local MCP server that builds an offline MkDocs site documenting your codebase

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
1.2.0
Listing updated
today

Similar MCP servers

About SnapDoczilla

SnapDoczilla is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

SnapDoczilla keeps documentation inside the repository as an offline HTML site anyone opens with a double click, with search and Mermaid diagrams included. The agent writes the pages from your real code, while this server handles the deterministic parts: installing the scaffold, finding what changed since the last documented commit, writing pages safely and running a strict build.

Pages cover backend architecture, API maps by resource, data models, frontend routes and component pages with real usage and source, plus ADRs. It works with stacks such as Spring, Express, FastAPI, Django, .NET, Go, Rails, React, Vue and Angular. It does not take screenshots, host anything or replace OpenAPI.

The server writes only inside documentation/source/, keeps the previous site if a build fails, and does not read your code itself because the client does that. The same project also ships as an agent skill, and the README says to use either the skill or the MCP server, not both.

Install

Run in a terminal

claude mcp add snapdoczilla -- uvx snapdoczilla-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "snapdoczilla": {
      "command": "uvx",
      "args": [
        "snapdoczilla-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "snapdoczilla": {
      "command": "uvx",
      "args": [
        "snapdoczilla-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "snapdoczilla": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "snapdoczilla-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "snapdoczilla": {
      "command": "uvx",
      "args": [
        "snapdoczilla-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "snapdoczilla": {
      "command": "uvx",
      "args": [
        "snapdoczilla-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

snapdoczilla_status
Shows install state, areas, undocumented commits and next step.
snapdoczilla_install
Scaffolds the documentation folder and downloads Mermaid.
snapdoczilla_get_rules
Returns the rules pages must follow.
snapdoczilla_changes_since_sync
Lists files and commits since the last documented commit.
snapdoczilla_write_page
Writes one page and adds it to navigation.
snapdoczilla_build_html
Runs a strict MkDocs build.
snapdoczilla_mark_synced
Records HEAD as the last documented commit.

What it does

Offline HTML docs
Open documentation/html/index.html with no install or internet.
Change tracking
Lists files and commits since the last documented commit.
Safe page writes
Writes confined to the docs source folder and added to navigation.
Strict builds
A failed build keeps the previous site.
Rules for pages
Pages must not invent facts and must embed real code.
Any stack
Documents common backend and frontend frameworks.

Good for

  • Document an existing project from its code
  • Update docs after a set of commits
  • Add a component page with real usage
  • Generate an ADR record for a decision

Pricing

Open source

Open source repository by Julio Varas; no price stated

SnapDoczilla FAQ

What does it need?

uv, git and bash; on Windows, Git for Windows.

Does the server read my code?

No. Your MCP client reads files with its own tools.

Can I use the skill and MCP together?

The README says use one or the other in a given agent.

How do readers open the docs?

Open documentation/html/index.html in a browser.

Is SnapDoczilla free?

Yes. SnapDoczilla is open source, so you can use and self-host it for free.

How do I add SnapDoczilla to Claude Code?

Run this command in your terminal: claude mcp add snapdoczilla -- uvx snapdoczilla-mcp

What are the best alternatives to SnapDoczilla?

The closest alternatives to SnapDoczilla are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers