如何把 Ant Design 官方 MCP Server 接入 Cursor、Claude Code 等 IDE 工具
如何把 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
验证接入结果
按文档提供的两条检查方式确认:
- 运行
antd setup --client <client> --check,核对 CLI 写出的配置是否与预期一致(<client>取claude/cursor/vscode/codex之一); - 回到 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 文档。