io.github.duckframeworkPublished by GitHub account duckframeworkv1.2.0Updated Oct 24, 2026
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
Official Duck Framework MCP server that gives an assistant the framework's documentation, component APIs, project and blueprint structure, and scaffolding for a
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.duckframework%2Fduckframework-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"duck-framework": {
"type": "http",
"url": "https://duckframework.com/mcp"
}
}
}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.
[Python >=3.10] [GitHub stars] [License] [Build Status]
(More badges — security, performance, integrations — on the Features page.)
Visit http://localhost:8000 — you're running Duck. For the full walkthrough (install options, project types, what gets generated), see Getting Started.
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.
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.
main.py, urls.py, views, pages, components, templates, and static files.Duck is updated regularly — check the repo for improvements and bug fixes.
Source: README.md at commit 12b74cc
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.
guiderequiredList available Duck Framework AI guides. Use this to discover available guides before fetching one with fetch_ai_guide(). Returns guide identifiers and their descriptions.
Takes no parameters.
Explain where Duck Framework blueprints can be located. Describes the supported blueprint layouts and when each organization approach is appropriate.
Takes no parameters.
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.
Takes no parameters.
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.
component_namerequiredReturn the standard Duck Framework project directory structure. Use this before creating or modifying projects to understand where files and directories belong.
Takes no parameters.
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.
coderequiredList all Duck Framework documentation categories and their pages. Use this when browsing available documentation without a specific search query.
versionAnalyze 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.
requestrequiredversionRebuild 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.
versionScaffold 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.
urlpatternsblueprint_namerequiredenable_static_direnable_template_dirprepend_name_to_urlsScaffold 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.
featuresproject_namerequiredFuzzy-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.
queryrequiredtop_kversioncategory100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
# Install Duck Frameworkpip install duckframework
# Create a projectduck makeproject myproject
# Change directory to myprojectcd myproject
# Run the webserverpython web/main.py # Optionally use duck runserver