aceternity-mcp

<div align="center">

A Model Context Protocol server for Aceternity UI components

Discover, explore, and install 106 Aceternity UI components directly from your AI assistant. Get intelligent recommendations, detailed metadata, and installation instructions.

[](https://pypi.org/project/aceternity-mcp/) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io/) [](./LICENSE)

</div>

---

Aceternity MCP is a pipx application that brings the Aceternity UI component library to your AI assistant through the Model Context Protocol. Your AI gets access to rich metadata including:

• Detailed descriptions for each component
• Visual characteristics and behavior patterns
• Use case recommendations and compatibility info
• Installation commands and dependencies
• Scoring metrics for animation intensity, customization level, and performance impact

This helps your AI make informed decisions about which components fit your design needs.

# 1. Install pipx (one-time setup)
brew install pipx
pipx ensurepath

# 2. Install Aceternity MCP
pipx install aceternity-mcp

# 3. Run the interactive setup
aceternity-mcp install

That's it! You're ready to use Aceternity MCP with your AI assistant.

Aceternity MCP provides a command-line interface for management:

| Command | Description | |---------|-------------| | aceternity-mcp install | Run interactive setup wizard | | aceternity-mcp update | Check for and install updates | | aceternity-mcp repair | Fix common installation issues | | aceternity-mcp status | Show installation health | | `aceternity-mcp di