Duck Framework MCP

io.github.duckframework由 GitHub 账号 duckframework 发布v1.2.0更新于 Oct 24, 2026

Official Duck Framework MCP server for AI-assisted development and project scaffolding.

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

Duck Framework 官方 MCP 服务器,为助手提供该框架的文档、组件 API、项目与蓝图结构,以及项目脚手架生成能力。

可以做什么
按分类浏览或模糊搜索 Duck Framework 文档,并列出和获取官方 AI 指南。查询内置组件 API,包括导入路径、容器类型和支持的关键字参数。获取标准项目与蓝图目录结构,以及蓝图可放置的位置说明。为较复杂的功能制定实现计划,给出建议的阅读顺序和步骤。生成新项目或蓝图脚手架,返回生成的文件内容和配置,而不是直接写入文件。检查组件或页面代码中的已知错误,例如错误的导入和 Heading 用法。
适用场景
在使用 AI 助手构建或扩展 Duck Framework Web 应用时,希望答案基于官方文档和已确认的组件 API,而不是猜测框架细节。也适合按官方约定新建 Duck 项目或蓝图。
运行要求
通过 streamable HTTP 连接 duckframework.com 的远程端点;未声明任何软件包、环境变量或请求头。reindex_docs 工具需要 admin 权限范围。
安装前请注意
reindex_docs 会抓取线上站点地图重建文档索引,新增并删除页面,且需要 admin 权限范围,应视为写操作。脚手架工具只返回生成的代码,不写入文件。代码检查仅针对已知模式的检查,并非完整的正确性验证。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Duck Framework MCP,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.duckframework%2Fduckframework-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "duck-framework": {
      "type": "http",
      "url": "https://duckframework.com/mcp"
    }
  }
}

README

[Duck Wordmark]

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


Quickstart

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

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

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.
  • Official Documentation — explore the full documentation.

Duck is updated regularly — check the repo for improvements and bug fixes.

来源:README.md,提交 12b74cc

工具

13

fetch_ai_guide

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.

输入参数guide必填

get_ai_guides

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.

无需输入参数。

get_blueprint_locations

Explain where Duck Framework blueprints can be located. Describes the supported blueprint layouts and when each organization approach is appropriate.

无需输入参数。

get_blueprint_structure

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.

无需输入参数。

get_component_api

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_name必填

get_project_structure

Return the standard Duck Framework project directory structure. Use this before creating or modifying projects to understand where files and directories belong.

无需输入参数。

lint_component_code

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.

输入参数code必填

list_doc_categories

List all Duck Framework documentation categories and their pages. Use this when browsing available documentation without a specific search query.

输入参数version

plan_feature

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.

输入参数request必填version

reindex_docs

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.

输入参数version

scaffold_blueprint

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.

输入参数urlpatternsblueprint_name必填enable_static_direnable_template_dirprepend_name_to_urls

scaffold_project

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.

输入参数featuresproject_name必填

search_docs

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.

输入参数query必填top_kversioncategory

版本历史

1
  1. v1.2.0最新Oct 23, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分