Official Duck Framework MCP server for AI-assisted development and project scaffolding.
io.github.duckframework/duckframework-mcp โ Model Context Protocol Server
The io.github.duckframework/duckframework-mcp server is an official Model Context Protocol (MCP) server for Duck Framework. It provides AI-assisted development support and project scaffolding for working with Duck Framework-based projects.
๐ ๏ธ Key Features
Official Duck Framework MCP server
AI-assisted development support
Project scaffolding
๐ Use Cases
Scaffolding new Duck Framework projects
Using AI-assisted workflows during development with Duck Framework
โก Developer Benefits
Centralizes Duck Framework support via an MCP server
Enables AI-assisted development and scaffolding through MCP
โ ๏ธ Limitations
No tool list, topics, or technical details (e.g., capabilities beyond scaffolding) were provided in the source data
Fetch an official Duck Framework AI guide.
Use this after get_ai_guides() to retrieve the full guide content for
AI-assisted Duck Framework development.
Always read the relevant guide before generating code instead of relying
on memory.
List available Duck Framework AI guides.
Use this to discover available guides before fetching one with
fetch_ai_guide().
Returns guide identifiers and their descriptions.
Return the standard internal structure of a Duck Framework blueprint.
Use this before generating a new blueprint or adding files to an existing
one to understand where components, pages, templates, automations, and
views belong.
Look up a built-in Duck Framework component API.
Returns the confirmed import path, container type, and supported keyword
arguments for a component without requiring the full HTML components guide
to be loaded.
Use this before using any component that has not already been confirmed.
Returns close-name suggestions when the component does not exist.
Return the standard Duck Framework project directory structure.
Use this before creating or modifying projects to understand where files
and directories belong.
Check Duck Framework component or page code for common mistakes.
Detects known patterns such as incorrect component imports, invalid page
imports, incorrect Heading usage, leading-underscore method names, and
separator comments.
This is a pattern check for known issues, not a complete correctness
validator. An empty result only means no known issues were detected.
Run this on generated component code before presenting it as final.
Analyze a Duck Framework feature request and create an implementation plan.
Returns relevant documentation to read and a suggested order of operations
before writing code. Use this before implementing non-trivial Duck
Framework features.
Rebuild the Duck Framework documentation index.
Crawls the live documentation sitemap for a given version and merges
the result in: curated tags/summary/category are preserved, new pages
are added, and pages no longer in the sitemap are removed.
Requires the admin scope.
Scaffold a new Duck Framework blueprint.
Generates a blueprint structure containing blueprint.py, views.py, and
optional UI, template, and static directories following the documented
Duck blueprint conventions.
Returns generated file contents and the settings configuration needed to
register the blueprint. This tool does not write files.
Scaffold a new Duck Framework project.
Returns the required CLI commands and generated file contents for
supported features with confirmed APIs. Unsupported features return
documentation guidance instead of generated code to avoid guessing
framework APIs.
This tool does not write files. It only returns generated content for the
calling client to add to the user's project directory.
Fuzzy-search the Duck Framework documentation.
Use this whenever the correct documentation page for a feature is
unknown. Returns ranked matches containing title, URL, category,
summary, and relevance score.
Duck Framework is an open-source Python web framework and web server with a built-in reactive UI engine and real-time WebSocket support.
Build high-performance, flexible, scalable, server-side reactive web applications โ without a separate frontend framework or a complex JavaScript stack.
(More badges โ security, performance, integrations โ on the Features page.)
Quickstart
sh
# Install Duck Framework
pip install duckframework
# Create a project
duck makeproject myproject
# Change directory to myprojectcd myproject
# Run the webserver
python web/main.py # Optionally use duck runserver
Visit http://localhost:8000 โ you're running Duck. For the full walkthrough (install options, project types, what gets generated), see Getting Started.
HTML & Lively Components
Duck includes everything you need to build your UI, while Quirl, the official component library, provides modern, reusable HTML and Lively components for building richer interfaces and interactions.
Documentation
New to Duck? Start with Getting Started, then Understanding the Project. You'll have everything you need to build your first app. Explore the other guides as your project grows.
1. Start Here
Getting Started โ install Duck, create a project, and start the server.
Understanding the Project โ understand main.py, urls.py, views, pages, components, templates, and static files.
2. Build with Duck
Native Apps โ get started with Duck Native and native app development.
Django Integration โ add Duck's HTTP/2, HTTPS, and security features to an existing Django project.
Features โ explore Duck's capabilities and planned features.
3. Resources
AI Guidelines โ use Duck with AI assistants and AI-assisted development.
About & Links โ discover real-world apps, useful links, and fun facts.
Contributing โ learn about contributing, reporting issues, sponsorship, and premium components.