AI 编辑器与 MCP

你的 AI 编辑器可以搜索 goodui、读取每个组件的文档和 props,并完成安装。有三种接入方式,优先用第一种可行的。

1. goodui MCP 服务器

一个 URL,无需账号:https://goodui.dev/api/mcp。工具: search_components, list_components, list_blocks, get_component, get_block, get_install_command, get_setup.

Claude Code

claude mcp add --transport http goodui https://goodui.dev/api/mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "goodui": { "url": "https://goodui.dev/api/mcp" }
  }
}

VS Code (Copilot)

.vscode/mcp.json
{
  "servers": {
    "goodui": { "type": "http", "url": "https://goodui.dev/api/mcp" }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "goodui": { "serverUrl": "https://goodui.dev/api/mcp" }
  }
}

Codex、Zed、Claude Desktop 及其他 stdio 客户端

只能启动本地服务器的客户端可以通过 mcp-remote 连接:

npx -y mcp-remote https://goodui.dev/api/mcp

在 Claude Desktop 中,你也可以在“设置 → 连接器”里用上面的 URL 添加自定义连接器。

通过 MCP 使用 Pro 区块

把许可证密钥放在请求头里发送,get_block 也会返回 Pro 源码,例如在 Claude Code 中:

claude mcp add --transport http goodui https://goodui.dev/api/mcp --header "Authorization: Bearer $GOODUI_LICENSE_KEY"

2. Agent 规则包

一条命令就把 goodui 的规则加到项目里的每个编辑器:该选哪个组件、怎么安装,以及色调、动效、RTL 和无障碍的规则。每个编辑器各有自己的文件,不会覆盖你已有的内容。

npx shadcn@latest add https://goodui.dev/r/agent.json
  • .claude/skills/goodui/SKILL.md: Claude Code 技能
  • .cursor/rules/goodui.mdc: Cursor 规则
  • .github/instructions/goodui.instructions.md: GitHub Copilot
  • .windsurf/rules/goodui.md: Windsurf 规则

对于 Codex、Amp 及其他读取 AGENTS.md 的工具,在 AGENTS.md 里加一行: UI: follow .claude/skills/goodui/SKILL.md

3. 任何聊天都能用的 Markdown

可以这样问

  • 用 goodui 做一个定价区块:月付/年付切换、滚动数字、发光的主按钮。
  • 把 goodui 资源时间线加到排班页面,并接上我们的预约数据。
  • 让这个设置表单改用 goodui 的输入框、开关和下拉选择,并翻译成德语。