MCP Server Installation

Install and configure the Aki UI MCP server for your AI development workflow.

Installation Methods

Install from npm

The easiest way to install the Aki UI MCP server is through npm:

Global Installation (Recommended)

npm install -g @akitectio/aki-ui-mcp-server

Local Installation

npm install @akitectio/aki-ui-mcp-server

Verify Installation

aki-ui-mcp --version

Requirements

Node.js 18+ and npm 8+ are required for installation.

Configuration

Claude Desktop Configuration

Add the MCP server to your Claude Desktop configuration:

1. Open Claude Desktop Settings

Navigate to Settings → Developer → MCP Servers

2. Add Configuration

{
  "mcpServers": {
    "aki-ui": {
      "command": "aki-ui-mcp",
      "args": [],
      "env": {}
    }
  }
}

3. Restart Claude Desktop

Restart the application to load the new MCP server configuration.

Cursor IDE Configuration

Configure Cursor IDE to use the Aki UI MCP server:

1. Open Cursor Settings

Go to Preferences → Extensions → MCP

2. Add Server Configuration

{
  "mcp": {
    "servers": [
      {
        "name": "aki-ui",
        "command": "aki-ui-mcp",
        "args": ["--port", "3000"]
      }
    ]
  }
}

VS Code with Continue.dev

Use the MCP server with Continue.dev extension in VS Code:

1. Install Continue.dev Extension

code --install-extension continue.continue

2. Configure Continue.dev

Edit .continue/config.json:

{
  "models": [...],
  "mcpServers": [
    {
      "name": "aki-ui",
      "command": "aki-ui-mcp",
      "args": []
    }
  ]
}

Environment Variables

Configure the MCP server behavior using environment variables:

Variable	Default	Description
MCP_PORT	3000	Port for MCP server
MCP_HOST	localhost	Host address
LOG_LEVEL	info	Logging level (debug, info, warn, error)
CACHE_TTL	3600	Cache time-to-live in seconds

Example .env file:

MCP_PORT=3001
LOG_LEVEL=debug
CACHE_TTL=7200

Verify Installation

1. Check Server Status

aki-ui-mcp --status

2. Test MCP Connection

aki-ui-mcp --test

3. List Available Tools

aki-ui-mcp --list-tools

Expected Output

✓ Aki UI MCP Server v1.1.4
✓ Connection: OK
✓ Available tools: 15
✓ Ready to use with AI assistants

Troubleshooting

Common Issues

Command not found: aki-ui-mcp

The global installation didn't add the command to your PATH.

Solution: Try running with npx: npx @akitectio/aki-ui-mcp-server

Permission denied during installation

Insufficient permissions for global installation.

Solution: Use sudo: sudo npm install -g @akitectio/aki-ui-mcp-server

MCP server not responding

The server may not be running or configured correctly.

Solution: Check the logs: aki-ui-mcp --logs

Getting Help

If you encounter issues not covered here:

GitHubReport an issue

DiscussionsCommunity support

DocsCheck the usage guide for examples

Next Steps

Now that you have the MCP server installed, you can:

Learn UsageExplore available tools and commands API ReferenceDetailed documentation of all functions