醋酸MCP
Aceternity UI组件的模型上下文协议服务器
从您的AI助手中发现、搜索和安装106个Aceternity UI组件。生成完整页面布局,获取上下文感知建议,并使用单个命令安装所有内容。
 ](https://www.npmjs.com/package/aceternity-mcp)    
______________________________________________________________________
安装
pipx install aceternity-mcp
aceternity-mcp install重启你的AI工具。完成。
它的作用
您的AI助手将获得11个使用Aceternity UI的工具:
| 工具 | 它做什么 |
|---|---|
generate_page_layout | 生成包含部分、组件和安装命令的完整页面布局 |
search_components | 在名称、描述、标签和类别之间进行全文搜索 |
recommend_components | 获取用例或设计目标的建议 |
recommend_combination | 获取每个页面部分的组件建议 |
match_components_to_project | 将组件与整个项目描述相匹配 |
list_components | 列出所有106个带有可选过滤器的组件 |
list_categories | 显示所有17个包含组件计数的类别 |
get_component | 获取单个组件的完整元数据 |
get_category | 获取一个类别中的所有组件 |
install_component | 获取安装命令、依赖项和安装步骤 |
filter_by_scores | 按视觉强度、动画、性能等过滤。 |
页面布局生成器
突出的特点。让你的AI生成一个完整的页面布局,它会返回:
- 为每个角色订购了带有推荐组件的部分
- 设计色调检测(深色、高级、现代、极简等)
- 使用17个角色简介进行部门特定评分
- 跨部分消除重复的组件
- 每个部分的实施说明
- 一次性批量安装所有组件的命令
- 性能估计和依赖关系摘要
7种页面类型: 登陆、saas、仪表板、投资组合、电子商务、博客、文档
示例提示:
"Generate a page layout for a dark premium AI SaaS landing page"
"Build me a fintech dashboard layout with analytics"
"Create a portfolio page with 3D effects and scroll animations"
"Design an e-commerce store layout for a clothing brand"每个组件的评分信号:
| 信号 | 描述 |
|---|---|
| 部门角色类别匹配 | 17个角色配置文件,包含首选类别 |
| 部分角色标签匹配 | 角色特定标签增强 |
| 部门得分权重 | 每个角色的调整维度权重 |
| 原型上下文 | 页面级评分(SaaS、仪表板、投资组合等) |
| 文本相关性 | 用户描述关键字匹配 |
| 设计音调一致性 | 增强与检测到的音调匹配的组件 |
| 依赖重用 | 共享npm依赖的奖励 |
示例提示
"Show me subtle dark background effects with low performance impact"
"Recommend a navbar + hero + CTA combination for a SaaS landing page"
"Find highly customizable card components for testimonials"
"Give me low-motion components suitable for a dashboard"
"Install Spotlight and show me what dependencies are needed"
"What components work well for dark mode dashboards?"
"Search for animated text effects"
"Filter components with visual intensity above 7 and low performance impact"支持的AI工具
| 工具 | 自动配置 |
|---|---|
| 克劳德桌面 | 是 |
| Claude Code CLI | 是 |
| 光标 | 是 |
| Cline(VS代码) | 是 |
| 风帆 | 是 |
| OpenCode | 是 |
跑 aceternity-mcp install 并且所有检测到的工具都是自动配置的。
手动配置
所有工具都使用相同的服务器命令:
{
"mcpServers": {
"aceternity-ui": {
"command": "aceternity-mcp-server",
"args": []
}
}
}| 工具 | 配置文件 |
|---|---|
| 光标 | ~/.cursor/mcp.json |
| 克劳德代码 | ~/.claude/mcp.json |
| Cline | VS代码扩展设置 |
| 风帆冲浪 | ~/.codeium/windsurf/mcp_config.json (使用 mcp_servers / aceternity_ui) |
| OpenCode | ~/.opencode/mcp.json |
CLI命令
| 命令 | 描述 |
|---|---|
aceternity-mcp install | 交互式设置向导 |
aceternity-mcp status | 显示安装运行状况 |
aceternity-mcp update | 检查并安装更新 |
aceternity-mcp repair | 修复注册表、配置或权限 |
aceternity-mcp diagnose | 输出JSON诊断 |
aceternity-mcp uninstall | 从所有AI工具中删除 |
aceternity-mcp --version | 显示版本 |
# Repair only the registry
aceternity-mcp repair --registry
# Repair only client configs
aceternity-mcp repair --configs
# Non-interactive update
aceternity-mcp update -y替代安装方法
码头工人
docker pull ghcr.io/devinoldenburg/aceternity-mcp
docker run -i ghcr.io/devinoldenburg/aceternity-mcpnpm(包装器)
npx aceternity-mcp-server需要单独安装Python包(pipx install aceternity-mcp).
点
pip install aceternity-mcp来源
git clone https://github.com/devinoldenburg/aceternity-mcp.git
cd aceternity-mcp
pipx install .组件注册表
17个类别的106个组件:
| 类别 | 计数 | 示例 |
|---|---|---|
| 背景 | 18 | 极光、光束、网格、聚光灯、漩涡 |
| 卡片 | 15 | 3D卡片,卡片悬停,可扩展卡片 |
| 文本效果 | 13 | 打字机、文本生成、渐变文本 |
| 滚动效果 | 11 | 视差、滚动显示、跟踪光束 |
| 可视化 | 9 | 地球仪、世界地图、SVG蒙版 |
| 英雄章节 | 8 | 英雄视差、聚光灯、灯光效果 |
| 导航 | 7 | 浮动码头,导航栏菜单 |
| 布局 | 81 | Bento网格、容器滚动、时间线 |
| 表单 | 6 | 输入、占位符、多步 |
| 3D效果 | 5 | 3D卡、3D针、球体 |
每个组件包括:详细描述、目的、行为、视觉特征、设计基调、难度级别、依赖关系、安装命令、兼容性标志和7个评分维度。
评分维度
每个组件在以下方面的评级为1-10:
| 维度 | 它测量什么 |
|---|---|
| 视觉强度 | 视觉主导程度(1=微妙,10=戏剧性) |
| 动画强度 | 运动量(1=静态,10=重动画) |
| 布局重要性 | 结构关键性(1=装饰性,10=必要性) |
| 易于定制 | 灵活性(1=刚性,10=非常可配置) |
| 着陆页匹配度 | 着陆页的适用性 |
| 仪表板适配性 | 仪表板的适用性 |
| 性能影响 | 运行时间成本(1=轻量级,10=重型) |
发展
git clone https://github.com/devinoldenburg/aceternity-mcp.git
cd aceternity-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
# Run tests
pytest tests/ -v
# Lint + type check
ruff check src/ tests/
mypy src/aceternity_mcp/ tests/
# Validate registry
python scripts/validate_registry.py质量
- 172个测试,9个原型,17个部分角色简介,7个页面模板
- ruff lint+格式,mypy严格,土匪安全扫描
- CI:每次推送都有质量门,发布时自动发布
安全
- 仅元数据:此存储库中没有Aceternity源代码、文档或图像
- 没有秘密:没有API密钥或凭据
- 孤立的:pipx提供沙盒虚拟环境
- 安装命令:指向Aceternity的官方
@aceternityshadcn注册表
故障排除
命令未找到 --快跑 pipx ensurepath 并重新启动您的终端。
未找到注册表 --快跑 aceternity-mcp repair 或 pipx reinstall aceternity-mcp.
MCP服务器未连接 --快跑 aceternity-mcp diagnose 并检查输出。修复配置 aceternity-mcp repair --configs.
更新问题 --快跑 pipx upgrade aceternity-mcp 或 pipx reinstall aceternity-mcp.
许可证
麻省理工学院——见 许可证.
