Ant设计MCP服务器
一个MCP服务器,允许AI代理直接访问Ant Design 5.x文档、组件规格、道具/API、设计令牌和主题配置。作为带有嵌入式数据库的单一原生二进制文件提供-没有外部依赖项,没有API密钥,完全离线。
特性
- 完整的Ant Design 5.x参考 --65个组件、设计符号、排版、颜色、间距、主题配置、可访问性和设计指南
- 9个MCP工具 --搜索、浏览和查询特定的设计系统元素
- 混合搜索 --FTS5 BM25全文搜索结合TF-IDF向量相似度
- 单个二进制 --通过嵌入式预构建SQLite数据库
go:embed,没有运行时依赖关系 - 纯Go --无CGO,可交叉编译到Linux、macOS和Windows
- MCP标准 --与支持模型上下文协议的任何代理或客户端配合使用
快速开始
1.建造
git clone https://github.com/Dxeo/antdesign-mcp.git
cd antdesign-mcp
go run ./cmd/seed/ # Build the Ant Design documentation database
go build -o antdesign-mcp ./cmd/server # Linux / macOS
go build -o antdesign-mcp.exe ./cmd/server # Windows2.配置
添加到MCP客户端配置中(请参阅 整合 针对特定客户)。
工具
| 工具 | 说明 |
|---|---|
search_docs | 跨所有Ant Design内容的混合全文+语义搜索 |
get_component | 按名称列出的完整组件规格(描述、规格、标记、解剖结构、状态) |
get_component_api | 组件的Props/neneneba API表(道具名称、类型、默认值、描述) |
get_design_tokens | 按类别、名称或角色查找设计令牌值 |
get_theme_config | 按层(种子、映射、别名)和类别划分的主题配置令牌 |
compare_components | 两个组件的并排规格、令牌和道具比较 |
get_guideline | 按主题分类的设计指南文档 |
get_accessibility_guidance | 每个组件或主题的可访问性要求和最佳实践 |
list_components | 按类别列出所有可用的Ant Design组件名称 |
整合
服务器通过以下方式进行通信 标准 使用MCP协议。任何兼容MCP的客户端都可以通过指向二进制文件来使用它。
此回购提供 AGENT.md 包含强制说明的文件,告诉代理何时以及如何使用antdesign mcp工具。将其内容复制到代理的系统提示符中, CLAUDE.md,或等效的配置文件,以确保代理主动查询Ant Design规范,而不是依赖于训练数据。
克劳德代码
添加 ~/.claude/settings.json 或项目 .mcp.json:
{
"mcpServers": {
"antdesign": {
"command": "/absolute/path/to/antdesign-mcp"
}
}
}然后添加以下内容 AGENT.md 到你的项目 CLAUDE.md 或 ~/.claude/CLAUDE.md.
建筑
- 构建时间 —
cmd/seed读取包含Ant Design 5.x组件规范、props/neneneba API、设计令牌、主题配置和指南的结构化JSON数据文件,构建FTS5和TF-IDF索引,并编写SQLite数据库 - 运行时 --服务器通过以下方式嵌入预构建的数据库
go:embed+SQLite VFS以只读方式打开,无磁盘I/O,并通过MCP stdio传输提供查询
antdesign-mcp/
├── cmd/
│ ├── server/ # MCP server entry point
│ └── seed/ # JSON-driven Ant Design database builder
├── data/ # Ant Design spec data as structured JSON
│ ├── components/ # 65 component families
│ ├── tokens/ # Color, typography, spacing, motion, border-radius, shadow
│ ├── theme/ # 3-tier theme tokens (seed, map, alias)
│ └── guidelines/ # Accessibility, layout, forms, navigation, feedback
├── embeds/ # Embedded database (go:embed target)
└── internal/
├── store/ # SQLite database layer (pure Go, FTS5)
├── search/ # Hybrid search (FTS5 BM25 + TF-IDF vectors)
├── vectorize/ # TF-IDF computation and cosine similarity
└── mcp/ # MCP server setup and 9 tool handlers组件覆盖范围
| 类别 | 计数 | 组件 |
|---|---|---|
| 常规 | 4 | 按钮、浮动按钮、图标、排版 |
| 布局 | 5 | 分隔符、柔性、网格、布局、空间 |
| 导航 | 7 | 锚点、面包屑、下拉菜单、菜单、分页、步骤、标签 |
| 数据输入 | 18 | 自动完成、级联、复选框、颜色选择器、日期选择器、表单、输入、输入编号、提及、无线电、速率、选择、滑块、开关、时间选择器、传输、树选择、上传 |
| 数据显示 | 20 | 头像、徽章、日历、卡片、旋转木马、折叠、描述、空、图像、列表、波波头、二维码、分段、统计、表格、标签、时间线、工具提示、教程、树 |
| 反馈 | 11 | 警报、抽屉、消息、模态、通知、弹出确认、进度、结果、骨架、旋转、水印 |
许可证
此项目根据GNU通用公共许可证v3.0获得许可——请参阅 许可证 文件以获取详细信息。
