ndekoui

dev.ndekocode.ui由 ui.ndekocode.dev 发布官方发布者v1.0.0更新于 Nov 7, 2026

Search, read and install ndekoui React components, blocks and templates with the shadcn CLI.

已验证Streamable HTTP可网页运行开发者工具媒体与设计

概览

AI 生成的概览

搜索 ndekoui React 组件库,返回条目源码与 shadcn 安装命令,并提供设计规范。

可以做什么
  • 按关键词、类型或分类搜索和浏览目录,并给出各分组的数量
  • 读取单个条目的完整文件源码、npm 依赖、注册表依赖及其网站页面
  • 为一个或多个条目生成 npm、pnpm、yarn 或 bun 下的 shadcn CLI 安装命令
  • 读取共享主题令牌(颜色、圆角、缓动、工具类)与编写一致界面的设计规范
适用场景
在使用 shadcn CLI 的 React 19 与 Tailwind CSS 4 项目中,需要助手查找合适的 ndekoui 基础组件、组件、区块或模板、阅读其源码并给出安装命令时使用。也适合让新界面遵循该库的主题与动效规则。
运行要求
远程 MCP 端点;未声明认证、环境变量或请求头。生成的安装命令假定项目已配置 shadcn CLI、React 19 与 Tailwind CSS 4。
安装前请注意
该服务器自称只读、不会改动项目,但它返回的安装命令需要你自行执行,会向代码库添加文件和依赖。运行前请先检查生成的命令与条目源码。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

{
  "mcpServers": {
    "ndekoui": {
      "type": "http",
      "url": "https://ui.ndekocode.dev/mcp"
    }
  }
}

README

ndekoui

Open-source React components that animate every change of state. 685 components in 36 categories, 66 blocks, 10 templates and 72 primitives, built on Base UI, motion and Tailwind CSS 4, installed with the shadcn CLI or through an MCP server.

Site and catalogue: ui.ndekocode.dev

What is in it

  • Primitives: 72 accessible building blocks on Base UI (button, field, select, menu, dialog, sheet, tabs, slider, chat input...). Try them at /kit.
  • Components: 685 compositions in 36 categories, from inputs and date pickers to notifications, comments and team lists. Browse them at /components.
  • Blocks: 66 whole sections of a product (app shells, boards, task lists, dashboards, billing, settings, pricing, heroes...). See them at /blocks.
  • Templates: 10 complete pages for applications and marketing sites, at /templates.
  • Motion: text effects, scroll animations, marquees, device frames and more, documented at /docs.
  • Theme: light and dark tokens, ink colours that pass AA, one-pixel hairlines and a few 3D materials, installed with every item.

Install a component

Every item is a shadcn registry item. In a project set up with the shadcn CLI, React 19 and Tailwind CSS 4:

bash
npx shadcn@latest add https://ui.ndekocode.dev/r/notification-28.json

The theme, the cn helper and every primitive the item uses come with it, and imports are rewritten to your own aliases.

To use the short form, declare the registry in components.json:

json
{  "registries": {    "@ndeko": "https://ui.ndekocode.dev/r/{name}.json"  }}
bash
npx shadcn@latest add @ndeko/notification-28

Use it from your editor

The MCP server at https://ui.ndekocode.dev/mcp lets Claude, Claude Code, Codex, Cursor, VS Code, Windsurf, Zed and other MCP clients search the catalogue, read the source of an item, get its install command and follow the design rules. Setup for each client: ui.ndekocode.dev/mcp/connect.

For language models, the catalogue is also described in llms.txt and, item by item, in llms-full.txt. The registry index is at r/registry.json.

Develop

bash
pnpm installpnpm dev              # the site on http://localhost:3000pnpm typecheckpnpm lintpnpm registry:build   # registry.json, preview indexes and public/r

Node.js 24 and pnpm are required.

Design system

The rules every item follows (tokens, lines, materials, motion, writing) are in docs/DESIGN-SYSTEM.md.

Contributing

Read the contributing guide and the port checklist in docs/ROADMAP.md.

Credits and licence

ndekoui is MIT licensed, see LICENCE.md. It started from Motion Primitives by ibelick and redraws compositions from the MIT edition of Origin UI; their notices and those of the brand marks are in THIRD_PARTY_NOTICES.md.

来源:README.md,提交 45e2f02

工具

7

search_items

Search items

Search the ndekoui registry by words, ranked like the search on ui.ndekocode.dev: titles first, then names, groups and descriptions. Use it before list_items when you know what you need ("pricing", "date range", "kanban"). Filter by kind: primitive, component, block, template, motion or lib.

输入参数kindlimitquery必填

list_items

List items

List ndekoui registry items of one kind. Kinds: primitive (Base UI building blocks such as button or dialog), component (ready compositions such as accordion-01), block (product sections such as heroes-01), template (whole pages), motion (animation components) and lib (theme, utilities, icons, sample images, hooks). Narrow with category: a category or group slug such as accordion, heroes or application, or a component family such as forms or overlays. Paged with offset and limit.

输入参数kind必填limitoffsetcategory

get_item

Get item

Get one ndekoui item by name: the full source of its files, its npm dependencies, the registry items it pulls in, the shadcn command that installs it and its page on ui.ndekocode.dev. Large templates return the source of their first files and list the rest; pass file with a path from that list to read one file.

输入参数filename必填

get_install_command

Get install command

Build the shadcn CLI command that installs one or more ndekoui items, for npm, pnpm, yarn or bun. Returns the command with full registry URLs, which works in any shadcn project, and the shorter @ndeko form for projects whose components.json declares the namespace.

输入参数names必填packageManager

get_theme

Get theme

Summarise the theme item every ndekoui piece depends on: the colour tokens with their light and dark values, the radius and easing tokens, and the utilities it adds (hairlines, chip-3d, keycap-3d, gem-plate, surface-raised, surface-brand). Read it before changing colours or writing new styles.

无需输入参数。

get_design_guidelines

Get design guidelines

The rules for writing UI that looks and moves like ndekoui: surfaces and hairlines, radius, colour, type, how to compose the Base UI primitives, the motion signatures and their timing, and what to avoid. Call it once before writing UI. Pass section with a number or a title ("7", "motion") to read one section of the design system in full, or "all" for the whole document.

输入参数section

list_categories

List categories

The map of the ndekoui catalogue with counts: primitive groups, component families and their categories, block groups, template groups, motion groups and library items. Use the slugs it returns as the category of list_items.

无需输入参数。

版本历史

1
  1. v1.0.0最新Nov 7, 2026

评分

已满足适用检查项的 100%

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

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