Aceternity MCP

Model Context Protocol server for Aceternity UI components

Discover, search, and install 106 Aceternity UI components from your AI assistant. Generate full page layouts, get context-aware recommendations, and install everything with a single command.

Install

pipx install aceternity-mcp
aceternity-mcp install

Restart your AI tool. Done.

What It Does

Your AI assistant gets 11 tools for working with Aceternity UI:

Page Layout Generator

The standout feature. Ask your AI to generate a complete page layout and it returns:

• Ordered sections with recommended components for each role
• Design tone detection (dark, premium, modern, minimal, etc.)
• Section-specific scoring using 17 role profiles
• De-duplicated components across sections
• Implementation notes for every section
• Batch install command for all components at once
• Performance estimate and dependency summary

7 page types: landing, saas, dashboard, portfolio, ecommerce, blog, documentation

Example prompts:

"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"

Scoring signals per component:

Example Prompts

"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"

Supported AI Tools

Run aceternity-mcp install and all detected tools are configured automatically.

Manual Configuration

All tools use the same server command:

{
  "mcpServers": {
    "aceternity-ui": {
      "command": "aceternity-mcp-server",
      "args": []
    }
  }
}

CLI Commands

# Repair only the registry
aceternity-mcp repair --registry

# Repair only client configs
aceternity-mcp repair --configs

# Non-interactive update
aceternity-mcp update -y

Alternative Install Methods

Docker

docker pull ghcr.io/devinoldenburg/aceternity-mcp
docker run -i ghcr.io/devinoldenburg/aceternity-mcp

npm (wrapper)

npx aceternity-mcp-server

Requires the Python package installed separately (pipx install aceternity-mcp).

pip

pip install aceternity-mcp

From source

git clone https://github.com/devinoldenburg/aceternity-mcp.git
cd aceternity-mcp
pipx install .

Component Registry

106 components across 17 categories:

Each component includes: detailed description, purpose, behavior, visual characteristics, design tone, difficulty level, dependencies, install command, compatibility flags, and 7 scoring dimensions.

Scoring Dimensions

Every component is rated 1-10 on:

Development

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

Quality

• 172 tests, 9 archetypes, 17 section role profiles, 7 page templates
• ruff lint + format, mypy strict, bandit security scan
• CI: quality gates on every push, auto-publish on release

Security

• Metadata only: No Aceternity source code, documentation, or images in this repository
• No secrets: No API keys or credentials
• Isolated: pipx provides sandboxed virtual environments
• Install commands: Point to Aceternity's official @aceternity shadcn registry

Troubleshooting

Command not found -- Run pipx ensurepath and restart your terminal.

Registry not found -- Run aceternity-mcp repair or pipx reinstall aceternity-mcp.

MCP server not connecting -- Run aceternity-mcp diagnose and check the output. Repair configs with aceternity-mcp repair --configs.

Update issues -- Run pipx upgrade aceternity-mcp or pipx reinstall aceternity-mcp.

License

MIT -- see LICENSE.

Links

• PyPI
• npm
• Docker (ghcr.io)
• GitHub
• Issues
• Model Context Protocol
• Aceternity UI