如何把 Ant Design 官方 MCP Server 接入 Cursor、Claude Code 等 IDE 工具

原创2026-09-08 16:10:051,971 阅读
文章标签:前端UI组件设计系统

如何把 Ant Design 官方 MCP Server 接入 Cursor、Claude Code 等 IDE 工具

当你用 Cursor、Claude Code 或 VS Code 这类 AI 编程工具开发 Ant Design 项目时,模型对组件 API、Design Token 和示例代码的了解可能滞后于项目实际使用的版本。Ant Design 官方从 @ant-design/cli v6.3.5 起提供了 MCP(Model Context Protocol)服务器:通过 antd mcp 启动后,AI 工具可以实时查询组件列表、属性规格、完整文档、可运行示例、Design Token 值、DOM 结构和跨版本 API 变更,共 8 个工具和 2 个提示词。本文介绍如何把这个官方 MCP Server 写入 Cursor、Claude Code、VS Code、Codex 等工具的配置文件,并用官方命令验证接入是否生效。

准备条件

MCP 配置以 npx 拉取 CLI 包的方式运行,因此只需要一个能访问 npm 的环境和 Node.js:

  • Node.js >=20.0.0(CLI 文档明确要求的版本下限)
  • 已安装 npm;CLI 也支持 pnpm add -g @ant-design/cli 或 bun add -g @ant-design/cli 全局安装

有两种使用 CLI 的方式,对应两种配置写法,任选其一:

# 方式一:全局安装,之后直接用 antd 命令
npm install -g @ant-design/cli

# 方式二:不安装,每次由 npx 临时执行(配置文件中推荐的方式)
npx -y @ant-design/cli mcp

方式二不需要全局包,配置中用 npx 启动即可,是文档给出的默认配置写法。

先本地验证 MCP 服务能启动

在写任何 IDE 配置之前,先确认 CLI 能在你的环境里启动 MCP 服务:

antd mcp
# 未全局安装时
npx -y @ant-design/cli mcp

该命令的作用是"启动 MCP 服务,供 IDE 集成"。能正常驻留运行说明 CLI 与网络环境没问题,之后 IDE 报错就可以排除服务本身的原因,转而检查配置文件。

如果希望 MCP 服务返回的组件知识对应某个固定的 antd 版本(例如项目锁定在 5.20.0),可以在参数中追加 --version:

{
  "mcpServers": {
    "antd": {
      "command": "npx",
      "args": ["-y", "@ant-design/cli", "mcp", "--version", "5.20.0"]
    }
  }
}

不加 --version 时,CLI 按"命令行参数、node_modules/antd、package.json 依赖声明、默认回退版本"的顺序自动检测项目版本。

接入路径一:手工写入 IDE 配置文件(主路径)

文档为每个工具指明了配置位置,核心都是同一段 JSON。以 Cursor 和 Claude Code 为例:

Cursor

把配置写入项目内的 .cursor/mcp.json,或通过"设置 → 功能 → MCP"添加:

{
  "mcpServers": {
    "antd": {
      "command": "npx",
      "args": ["-y", "@ant-design/cli", "mcp"]
    }
  }
}

Claude Code

把同一段 mcpServers 配置添加到 Claude 设置的 mcpServers 字段中。

VS Code

注意 VS Code 的配置键与其余工具不同:外层是 servers 而不是 mcpServers。写入 .vscode/mcp.json 或通过"设置 → MCP"添加:

{
  "servers": {
    "antd": {
      "command": "npx",
      "args": ["-y", "@ant-design/cli", "mcp"]
    }
  }
}

Codex

写入 .codex/mcp.json,结构与 Cursor 相同(mcpServers 键)。

其他工具

文档还给出了以下工具的落盘位置,配置内容均为 mcpServers 加同一段 antd 条目:

工具 配置位置
Windsurf ~/.codeium/windsurf/mcp_config.json
Gemini CLI 工具的 MCP 配置
Trae 工具的 MCP 设置
Qoder 工具的 MCP 配置
Neovate Code 设置中配置 MCP,或用提示词描述任务

如果已按准备条件全局安装了 CLI,可以把 command 与 args 简化为:

{
  "mcpServers": {
    "antd": {
      "command": "antd",
      "args": ["mcp"]
    }
  }
}

保存配置并重启(或刷新)对应 IDE 的 AI 面板后,该 MCP 服务器会提供以下工具,AI 在编码过程中按需调用:

工具 说明
antd_list 列出可用组件
antd_info 获取组件属性规格
antd_doc 获取完整文档
antd_demo 获取可运行的代码示例
antd_token 查询 Design Token 值
antd_design_md 获取设计语言文档
antd_semantic 查看 DOM 结构和样式钩子
antd_changelog 分析跨版本 API 变更

提示词有 antd-expert(将 Agent 定位为 Ant Design 专家)和 antd-page-generator(辅助基于组件的页面创建)。

接入路径二:用 antd setup 自动写入配置(可选)

不想手工建文件时,CLI 可以自动写入受支持项目的配置:

antd setup --client claude
antd setup --client cursor --mode both
antd setup --client vscode --write-instructions
antd setup --client codex

适用条件与参数:

  • 支持的客户端只有 claude、cursor、vscode、codex 四种,其余工具需走上面的手工配置路径;
  • Setup 模式(--mode)包括 mcp、skill 和 both,skill 指安装 CLI 内置的 Ant Design Skill 文件,both 同时写入 MCP 配置与 Skill;
  • --write-instructions 会额外写入说明文件(文档以 vscode 客户端为例);
  • 写入前想先看会改什么,用 --dry-run 预览;想确认已有配置是否正确,用 --check:
antd setup --client claude --dry-run
antd setup --client claude --check

验证接入结果

按文档提供的两条检查方式确认:

  1. 运行 antd setup --client <client> --check,核对 CLI 写出的配置是否与预期一致(<client> 取 claude / cursor / vscode / codex 之一);
  2. 回到 IDE:AI 工具应能列出名为 antd 的 MCP 服务器,并可调用上表中的 8 个工具。可以在对话中让 AI"用 antd 查询 Button 组件的属性",若能返回 antd_info 的结果,说明链路已通。

如果 IDE 中服务器始终连不上,先回到本文"先本地验证 MCP 服务能启动"一节,用 antd mcp / npx -y @ant-design/cli mcp 排除 CLI 与网络问题,再逐项核对配置文件路径、mcpServers(VS Code 为 servers)键名和 args 是否与文档一致。

工具不支持 MCP 时的替代路径

如果你的 AI 工具没有 MCP 支持,文档给出的替代方案是 LLMs.txt:让工具直接读取 Ant Design 发布的结构化文档——https://ant.design/llms.txt 为所有组件的结构化概览,https://ant.design/llms-full.txt 为包含示例的完整文档。这是 MCP 之外的降级手段,两者不要同时接入同一个工具。

更完整的命令说明(全部 18 条命令、全局参数、环境变量)见 CLI 文档,MCP 的英文对照版本见 MCP Server 文档。

登录后查看全文
ant-design