Echo UI

com.echo-ui由 echo-ui.com 发布官方发布者v0.3.5更新于 Nov 7, 2026

A tactile React component library, and the design system that keeps your AI agent on-brand.

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

概览

AI 生成的概览

Echo UI 的 MCP 服务器让编码助手查询 Echo React 组件、按 Echo 规则检查代码,并在写界面之前挑选视觉风格。

可以做什么
  • 搜索与读取组件:按用途找到合适的组件,或获取单个组件的完整记录、示例、属性与反模式
  • 查询设计令牌:颜色角色、声音名称与动效词汇
  • 检查代码:用 Echo 规则审查代码片段,并给出每处问题的 Echo 修法
  • 检查无障碍:列出使用者仍可能出错的规则,以及某个组件自身的测试记录
  • 查找与应用风格:列出 Echo 的风格、按产品画像排序、校验风格文件,并给出套用所需的命令或主题 CSS
适用场景
在使用 Echo UI 的 React 组件库构建界面时使用,让助手查阅真实注册表而不是猜测属性、令牌或无障碍规则。对于无法运行 CLI 的纯网页聊天客户端也有用,因为托管端点提供同样的检查。
运行要求
可使用 mcp.echo-ui.com 的托管远程端点(无需账号、无需安装),或通过 npx 运行本地 npm 包,后者需要 Node.js 20 或更高版本。无需 API 密钥或环境变量;可选的 ECHO_CATALOG 与 ECHO_REGISTRY 变量可指向分支或本地构建。
安装前请注意
check_code 会把传入的代码发送到托管服务器;README 称不会保存,请求日志只记录路径、状态和耗时,但托管方会保留这些日志及来源地址最多 7 天。托管端点有速率限制,并会拒绝过大的代码。安装组件和风格会改动用户项目,运行前请先查看打印出的命令。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

{
  "mcpServers": {
    "echo-ui": {
      "type": "http",
      "url": "https://mcp.echo-ui.com/mcp"
    }
  }
}

README

echo-ui-mcp

An MCP server for Echo UI. It gives a coding agent ten tools over the Echo UI registry, so the agent can look up a component's props, usage, accessibility notes and anti-patterns before it writes code with it, check what it wrote, and find and wear a style.

Install

Every client runs the same command:

json
{  "mcpServers": {    "echo-ui": {      "command": "npx",      "args": ["-y", "echo-ui-mcp"]    }  }}
  • Claude Code: claude mcp add echo-ui -- npx -y echo-ui-mcp
  • Codex: add it to ~/.codex/config.toml as [mcp_servers.echo-ui], with command = "npx" and args = ["-y", "echo-ui-mcp"].
  • Cursor: add the block above to .cursor/mcp.json.
  • VS Code: add it to .vscode/mcp.json, under servers instead of mcpServers.
  • Other clients: any client that runs a stdio MCP server takes the same command.

Requires Node.js 20 or later.

Hosted

For tools that only connect to a server on the web (ChatGPT, claude.ai, Lovable, v0, Bolt, Claude Design), the same tools run at https://mcp.echo-ui.com/mcp: nothing to install, no account. Add it as a custom connector (a remote MCP server) with that address, or:

  • Claude Code: claude mcp add --transport http echo-ui https://mcp.echo-ui.com/mcp
  • Cursor: { "mcpServers": { "echo-ui": { "url": "https://mcp.echo-ui.com/mcp" } } }

It reads the same published documents as the package, and keeps nothing it's sent: check_code reads your code and forgets it, and its request logs hold the path, the status and the timing, never a body. Cloudflare, which hosts it, keeps those logs, with the address a request came from, for up to 7 days (privacy policy). check_code takes up to 200,000 characters, a request past what that needs is refused with 413 before it's read, and one address can send 300 requests in ten seconds and about 2 MB of large code a minute, each whole 16 KB of a request counting (429 past either, with Retry-After).

In Claude and ChatGPT, with Echo's skills

Echo's plugin carries the hosted server and Echo's three skills (Echo UI, Design Eye and Style Fit) in one install: echo-ui.com/docs/plugin. In ChatGPT it's in the plugin directory. Until Claude's directory lists it too, it installs from the docs: the Claude ZIP for claude.ai and Claude Code, and the Codex ZIP for Codex and ChatGPT desktop.

Tools

ToolTakesAnswers with
search_componentsquery?The item for a job ("a settings toggle", "confirm a delete"), or a plain "Echo has nothing for this yet", then one line per matching component with its install command. The same answer as the CLI's which. With no query, every component.
get_componentnameThe full record: description, install command, usage, composition, examples, accessibility, motion & sound, props and anti-patterns. Accepts echo-hardware-button, hardware-button or HardwareButton.
get_tokens—The colour roles (--echo-*), sound names and motion names.
get_examplesnameJust the examples for one component.
get_accessibilityname?The rules a consumer of Echo can still get wrong. With a name, that component's own record of what was tested and what is not.
check_codecode, file?Echo's check on a piece of code: the same rules as npx echo-ui-cli check, against the default theme, each finding with the Echo way to fix it. For a tool with no terminal to run the CLI in.
list_stylesname?Echo's own styles, each with its one line and fingerprint; with a name, that style in full.
fit_stylesprofile, tolerance?, yours?Echo's styles and the builder's own (by fingerprint), ranked against where the product sits on the seven axes. The same arithmetic as npx echo-ui-cli style fit.
check_stylestyleWhether a style.json is one Echo can apply, as npx echo-ui-cli style check says it.
wear_stylename or style, files?A link that makes the Echo site wear the style (one of Echo's whole, your own in its colours), the command that puts it in a project, and, for a project with no terminal, its theme CSS and DESIGN.md.

When it connects, the server also sends instructions: how to set the project up, how to wire the theme and sound, and the corrections agents most often need (Base UI's package is @base-ui/react; Echo components are installed with npx echo-ui-cli add, not npm install).

get_component returns the same text as the component's page in the Echo UI docs and its entry in llms-full.txt, plus what the component ships as: its version, the echo-ui-core range it needs, and its accessibility record. That half is read from the same registry echo-ui-cli installs from, with the same client, so the two cannot disagree.

Configuration

The server reads two published documents and re-reads them after five minutes: the catalog at https://echo-ui.com/r/catalog.json and the registry at https://echo-ui.com/e. To point it at a fork or a local build, set either:

json
{  "mcpServers": {    "echo-ui": {      "command": "npx",      "args": ["-y", "echo-ui-mcp"],      "env": {        "ECHO_CATALOG": "/absolute/path/to/catalog.json",        "ECHO_REGISTRY": "https://example.com/e"      }    }  }}

If the registry cannot be reached the server still answers from the catalog, with the versions the catalog was built at. A copy it has already read keeps answering while its source can't be read, and is tried again every minute. If a file does not match the hash the registry published for it, the server says so rather than answering.

License

MIT

来源:mcp/README.md,提交 9f8a4fc

工具

10

search_components

Search Echo UI components

Find the Echo UI item for a job ("a settings toggle", "confirm a delete") or by name. Leads with the best fit, or says plainly that Echo has nothing for the job yet, then lists every match with its install command. The cheapest way to find out what exists, and the first call before writing Echo code.

输入参数query

get_component

Get an Echo UI component

The full record for one component: description, install command, usage (imports + smallest working snippet), composition (part tree), examples, accessibility, motion & sound, prop table and anti-patterns. It's for before writing code that uses the component: the anti-patterns are the part a model gets wrong from priors.

输入参数name必填

get_tokens

Get Echo UI tokens

The token families: Layer-3 semantic colour roles (--echo-*), sound names, motion's whole vocabulary — the motion tokens, the spring presets, the morph feels and the CSS duration and ease steps — and the shadow recipes. Any name a component's record lists under Motion is here. Echo components are styled and moved only through these: a hex, a duration or a shadow written by hand, or a token name that isn't here, is off Echo's system.

无需输入参数。

get_examples

Get usage examples

Just the usage examples for one component, without the rest of its record. For when the component is already chosen and only its calling convention is needed.

输入参数name必填

get_accessibility

Get Echo UI accessibility rules

The accessibility rules a consumer of Echo can still get wrong — names on controls, form errors, announcements, focus and target size — and, with a name, what that component's accessibility was actually tested against. Echo guarantees WCAG 2.2 AA; this is the part the guarantee cannot cover for you. It's for before building a form, a dialog or anything icon-only.

输入参数name

check_code

Check code against Echo

Echo's check on a piece of code you've written or are about to write: colours, spacing, radii, shadows and timing off Echo's scales, raw elements where Echo has the component, props a component doesn't take, controls without a name, markup a keyboard or screen reader can't use, restyling Echo from outside, and the screen rules one file can show. The same rules as `npx echo-ui-cli check`, which runs on a whole project with its own theme; this one uses the default theme. Each finding says the Echo way to fix it.

输入参数code必填file

list_styles

List Echo UI styles

Echo's own styles, the looks Echo publishes, each with its one line and its fingerprint on the seven axes styles are placed on; or, with a name, one of them in full: its settings, rules, refusals, fonts, decisions and the slop police's word. The builder's own styles aren't here: they're in their library or the conversation, and fit_styles weighs them with Echo's.

输入参数name

fit_styles

Rank styles for a product

Style Fit's shortlist: Echo's styles, and the builder's own passed in, measured against where a product sits on the seven axes (warmth, volume, density, formality, era, craft, ornament) and put in order: a style that misses a locked axis last, then least past tolerance first, then nearest. The same arithmetic as `npx echo-ui-cli style fit`. It orders; it doesn't pick.

输入参数yoursprofile必填tolerance

check_style

Check a style

Whether a style.json is one Echo can apply, as `npx echo-ui-cli style check` says it: what stops it, the device it makes (light or dark), what the theme corrects for AA contrast, what the slop police stops (with the question for the builder) or the builder kept, and the decisions it leaves open.

输入参数style必填

wear_style

Wear a style

What a style gives a project: a link that makes the whole Echo site wear its colours, the commands that put it in a project, and, for a project without a terminal, its theme CSS and a DESIGN.md with its rules. One of Echo's styles by name, or the builder's own style.json. A style the slop police stops isn't worn; the answer says what to ask the builder.

输入参数namefilesstyle

版本历史

1
  1. v0.3.5最新Nov 7, 2026

评分

已满足适用检查项的 100%

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

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