NiceGUI MCP
NiceGUI MCP is a docs-first Model Context Protocol server for local NiceGUI development. It bundles curated guidance, searches that guidance, analyzes pasted NiceGUI code for common problems, applies a narrow safe fixer set, and generates starter patterns for real app workflows.
What It Does
- Guidance lookup for common NiceGUI problem areas
- Topic search across bundled docs
- Static analysis for layout, scrolling, async, dialog, styling, and architecture issues
- Deterministic safe fixes for a small allowlisted set of patterns
- Starter generation for layout shells, dialogs, async flows, forms, tables, and controller/service splits
What It Does Not Do
- repo-wide indexing
- arbitrary code execution
- browser automation
- embeddings or vector search
- hosted multi-user deployment
- large-scale automated refactors
Bundled Topics
layout_spacing_scrollingasync_tasks_performancestyling_themingdialogsstate_managementcomponent_architectureforms_validationdata_views_tables_chartstestingdeployment_runtime
Tools
list_topics()get_guidance(topic)search_guidance(query, topics=None)analyze_nicegui_code(code, focus=None, filename=None, context=None)fix_nicegui_code(code, aggressive=False)generate_nicegui_component(kind, mode='default', details_json=None)
Resources
nicegui://topics/indexnicegui://guidance/{topic}
Recommended Workflow
- Search or read guidance for the problem area.
- Analyze the relevant NiceGUI snippet.
- Apply safe fixes where the fixer set supports them.
- Reanalyze the updated code.
- Generate a better pattern when the issue is architectural rather than local.
Installation
uv syncRun
uv run nicegui-mcpTest
uv run pytest -qExample MCP Client Config
{
"mcpServers": {
"nicegui-mcp": {
"command": "uv",
"args": ["run", "--directory", "/path/to/nicegui-mcp", "nicegui-mcp"]
}
}
}Project Layout
nicegui_mcp/
├── analyzers.py
├── docs/
├── fixers.py
├── generators.py
├── models.py
├── profile.py
├── registry.py
└── server.py
