组件构建mcp
实现以下功能的MCP(模型上下文协议)服务器 组件.构建 用于分级、生成和验证UI组件的规范。
](https://www.npmjs.com/package/components-build-mcp) 
关于
此MCP服务器为AI助手提供以下工具:
- 访问完整的组件。构建规范 -嵌入并可搜索的完整文档
- 等级组件 -根据规范规则验证任何组件
- 生成符合要求的组件 -创建遵循所有最佳实践的新组件
- 搜索文档 -找到特定的模式、规则或概念
框架支持
| 功能 | 支持的框架 |
|---|---|
| 规格说明 | 框架无关 |
| 评分 | 框架无关(React、Vue、Svelte、Angular等) |
| 模板 | React+TypeScript |
分级规则检查适用于任何框架的通用模式(可访问性、组合、数据属性)。
安装
适用于克劳德代码/克劳德桌面
npm install -g components-build-mcp添加到您的Claude配置(~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"components-build": {
"command": "components-build-mcp"
}
}
}促进地方发展
git clone https://github.com/getlokiui/components-build-mcp.git
cd components-build-mcp
npm install
npm run build在Claude配置中添加完整路径:
{
"mcpServers": {
"components-build": {
"command": "node",
"args": ["/path/to/components-build-mcp/dist/index.js"]
}
}
}可用工具
文档工具
| 工具 | 说明 |
|---|---|
get_specification | 获取完整规格或特定章节 |
search_specification | 搜索“aria”、“CVA”、“data slot”等术语 |
list_specification_sections | 列出所有16个文档部分 |
评分和验证工具
| 工具 | 说明 |
|---|---|
grade_component | 评分代码并获得详细的分数反馈 |
check_compliance | 快速通过/失败检查(阈值:80/100) |
get_rules | 按类别获取评分规则 |
get_rule | 获取特定规则的详细信息 |
list_rules | 列出所有规则及其严重性和权重 |
生成工具
| 工具 | 说明 |
|---|---|
generate_component | 从模板生成兼容组件 |
get_template | 获取参考模板(按钮、卡片、输入等) |
get_quick_reference | 获取备忘单 |
使用示例
配置后,询问您的AI助手:
"Show me the components.build spec section on accessibility"
"Grade this component against the spec:
export const Button = ({ children }) => {children}"
"Generate a Card component with composable sub-components"
"Search the spec for keyboard navigation patterns"
"What rules does the grader check for?"规范章节
完整的组件构建规范包括:
| 第节 | 说明 |
|---|---|
overview | 引言与目的 |
definitions | 术语(图元、组件、块等) |
principles | 核心原则(可组合性、可访问性等) |
composition | 根/触发器/内容模式 |
accessibility | 完成11年指南 |
designTokens | CSS变量和主题 |
state | 受控/非受控状态 |
styling | cn()、CVA、顺风合并 |
types | TypeScript模式 |
polymorphism | “as”道具 |
asChild | 根槽图案 |
dataAttributes | 数据状态/数据槽模式 |
docs | 文件编制标准 |
registry | shadcn CLI分发 |
marketplaces | 组件市场 |
npm | NPM分布 |
分级规则
组件根据以下因素进行分级:
- 类型 -扩展HTML道具,导出类型,正确传播道具
- 样式 -使用cn()实用程序、类顺序、设计标记
- 无障碍 -ARIA属性、键盘导航、语义HTML
- 构图 -单元素包装,可组合图案
- 状态 -支持受控和非受控使用
- 命名 -遵循约定(根、触发器、内容等)
HTTP API
与Vertel兼容的HTTP API也可用于非MCP使用:
# Deploy to Vercel
cd components-build-mcp
vercel --prod终点:
GET /?action=rules-获取所有规则POST /?action=grade-等级组件代码POST /?action=generate-生成组件GET /?action=quick-reference-获取备忘单
鸣谢
该项目实现了 组件.构建 规范。
规格为:
- 版权所有2023 Vercel,股份有限公司。
- 根据以下许可 Apache许可证2.0
此MCP服务器是Audrey Klammer的社区项目 未正式隶属于或认可Vercel,股份有限公司。
许可证
Apache许可证2.0-请参阅 许可证 了解详情。
贡献
欢迎投稿!请先阅读组件。构建规范,以了解模式和规则。
