mcpField
K
Kodadocs

Kodadocs

Local
github.com/KodadocsMemory & Knowledge2Updated 34w ago

About Kodadocs

Kodadocs is an open-source Claude Code MCP tool and CLI that generates a VitePress help center from a web app's code and browser screenshots. It is for teams documenting their apps, with route discovery, annotated UI images, and generated articles in one workflow.

Key features

  1. 01Detect web frameworks and discover routes
  2. 02Capture screenshots with a headless browser
  3. 03Blur PII and annotate UI elements
  4. 04Generate documentation articles
  5. 05Assemble and deploy a VitePress site

Use cases

  1. 01Create a help center from an app codebase
  2. 02Document routes behind a login
  3. 03Prepare annotated screenshots for feature guides

MCP support

Its MCP server provides tools for framework detection, route and code analysis, screenshot capture and annotation, VitePress assembly, and deployment. Claude Code can coordinate these steps.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"kodadocs": {
"command": "uvx",
"args": [
"kodadocs"
]
}
}
}
Run commanduvx kodadocs

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypikodadocs

Tools

9

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
project_pathstringYes

Details

From the project README

KodaDocs

PyPI version PyPI Downloads GitHub stars License: MIT Python 3.12+

kodadocs.com | Docs | AI-generated help docs for your web app — in minutes, not weeks.

KodaDocs is an open-source Claude Code MCP tool. Install it, tell Claude "Generate docs for my app", and get a complete help center with annotated screenshots and AI-written articles. Free to self-host. Pro Kit ($29) for unlimited pages, 12 skill workflows, and all premium themes. Optional hosted deploy ($5/mo) to yourapp.kodadocs.com.

KodaDocs demo — generate docs in one command

Quick Start

Add the MCP server to your Claude Code config (~/.claude/settings.json):

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

Install the browser for screenshots (one-time):

uvx --with kodadocs playwright install chromium

Then tell Claude:

"Generate help docs for my app"

Claude reads your code, captures screenshots, writes documentation, and assembles a VitePress help center — all through MCP tools.

CLI (optional)

For power users who want direct CLI access:

pip install kodadocs
kodadocs generate .
kodadocs deploy .

Showcase

See what KodaDocs generates — these docs were created in under 2 minutes:

ProjectFrameworkLive Docs
HonoHonohono.kodadocs.com
DrizzleDrizzle ORMdrizzle.kodadocs.com
Create T3 AppNext.jscreate-t3-app.kodadocs.com

Want to see your project here? Generate docs with KodaDocs and let us know.

How It Works

Your web app ──► KodaDocs ──► Complete help center
                   │
                   ├── Detects framework (Next.js, Django, Flask, WordPress, ...)
                   ├── Discovers routes from source code
                   ├── Launches headless browser & authenticates
                   ├── Captures screenshots with PII blurring
                   ├── Draws numbered callouts on UI elements
                   ├── Claude writes all articles
                   └── Assembles VitePress site & deploys
PhaseWhat happens
DiscoveryDetects framework, discovers routes from code
CaptureLaunches headless browser, authenticates, captures screenshots
AnnotationDraws numbered callouts on UI elements
Doc WritingClaude writes all articles (Getting Started, Feature Guides, FAQ, Troubleshooting)
AssemblyAssembles VitePress site with branding, search, and mobile layout
DeployDeploys to Cloudflare, Vercel, Netlify, GitHub Pages, or kodadocs.com

Supported Frameworks

Next.js, Nuxt, React, Vue, Angular, SvelteKit, Remix, Astro, Django, Flask, FastAPI, Rails, Laravel, Express, Hono, WordPress, Chrome Extensions, and more.

MCP Tools

ToolDescription
detect_frameworkAuto-detect web framework from project files
discover_routesStatic analysis of routes, services, and metadata
analyze_codebaseTree-sitter parsing for code chunks, error patterns, data models
capture_screenshotsHeadless browser capture with auth and PII blur
annotate_screenshotsNumbered callouts on UI elements via Pillow
assemble_vitepressBuild complete VitePress site from articles + screenshots
deploy_siteDeploy to hosting provider
save_manifest / load_manifestPersist and load pipeline state

Claude Code Skill

KodaDocs includes a skill file that teaches Claude how to orchestrate the full pipeline. To install it:

mkdir -p .claude/skills
cp kodadocs/skill/kodadocs.md .claude/skills/kodadocs.md

CLI

KodaDocs also works as a standalone CLI (requires pip install kodadocs):

kodadocs generate .                              # Run full pipeline
kodadocs generate . --url http://localhost:3000   # Override app URL
kodadocs generate . --user admin --pass secret    # Auth-gated apps
kodadocs deploy . --provider cloudflare           # Deploy to provider
kodadocs init .                                   # Interactive setup wizard
kodadocs config .                                 # View/update config
kodadocs mcp                                      # Start MCP server

Auth-Gated Apps

KodaDocs handles apps behind login walls automatically:

  1. Provide credentials via kodadocs init or --user / --pass flags
  2. KodaDocs logs in via headless browser, saves the session
  3. Post-auth crawl discovers routes invisible to unauthenticated visitors
  4. All screenshots are captured in the authenticated session

API Key

KodaDocs requires an Anthropic API key to generate documentation.

With Claude Code (MCP): The API key is provided automatically — no setup needed.

With the CLI: Set the key in your environment:

export ANTHROPIC_API_KEY=sk-ant-...

Pricing

FeatureFreePro Kit ($29)+ Hosting ($5/mo)
Pages per generation15UnlimitedUnlimited
FrameworksAll 18+All 18+All 18+
ThemesDefaultAll 6+ premiumAll 6+ premium
Custom brandingNoYesYes
Auth-gated appsNoYesYes
Skill files—12 pro workflows12 pro workflows
BadgeAlways shownRemovableRemovable
Self-host deployYesYesYes
Managed hosting——yourapp.kodadocs.com
Custom domain——help.yourapp.com
Search analytics——Yes

Users bring their own Anthropic API key — generation is never gated.

Get the Pro Kit — unlimited pages, premium themes, and 12 pro skill workflows.

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.