# SnapDoczilla

> SnapDoczilla is an open-source MCP server for developer tools. Local MCP server that builds an offline MkDocs site documenting your codebase. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Repository:** https://github.com/julvc/skills
- **MCP Registry name:** io.github.julvc/snapdoczilla
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add snapdoczilla -- uvx snapdoczilla-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/snapdoczilla
