@aegisx/mcp

MCP (Model Context Protocol) server for the AegisX platform. Provides AI assistants with access to AegisX UI components, CRUD generator commands, development patterns, and API contract discovery.

Features

• UI Components Reference - Browse and search 78+ AegisX UI components with full API documentation
• CRUD Generator Commands - Build and execute CRUD generation commands with 23 supported options (100% CLI alignment)
• Development Patterns - Access best practices, code templates, and architecture patterns
• API Contract Discovery - List, search, and validate API contracts across your codebase
• API Testing & Authentication - Login, test protected endpoints, decode JWT tokens, and track request history
• Design Tokens - Reference design tokens for colors, spacing, typography
• Development Standards - Access coding standards and guidelines

Data Synchronization

The component, command, and pattern data files are auto-generated from source libraries:

• src/data/components.ts - Generated from aegisx-ui components
• src/data/crud-commands.ts - Generated from aegisx-cli commands
• src/data/patterns.ts - Validated from existing patterns

⚠️ DO NOT EDIT MANUALLY - Changes will be overwritten on next sync.

Installation

NPM (Global)

npm install -g @aegisx/mcp

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "aegisx": {
      "command": "npx",
      "args": ["-y", "@aegisx/mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "aegisx": {
      "command": "aegisx-mcp"
    }
  }
}

Available Tools

UI Components

| Tool | Description | | -------------------------- | ------------------------------------------------------- | | aegisx_components_list | List all UI components, optionally filtered by category | | aegisx_components_get | Get detailed info about a specific component | | aegisx_components_search | Search components by name or description |

Example:

Use aegisx_components_get with name="Card" to see the Card component API.

CRUD Generator

| Tool | Description | | --------------------------- | ---------------------------------------------------- | | aegisx_crud_build_command | Build a CRUD generation command with options | | aegisx_crud_packages | View available packages (standard, enterprise, full) | | aegisx_crud_files | See what files will be generated | | aegisx_crud_troubleshoot | Get help with common issues | | aegisx_crud_workflow | Get complete workflow for a feature |

Example:

Use aegisx_crud_build_command with tableName="products" and withImport=true to get the command.

Development Patterns

| Tool | Description | | ------------------------- | ---------------------------------- | | aegisx_patterns_list | List all patterns by category | | aegisx_patterns_get | Get a specific pattern with code | | aegisx_patterns_search | Search patterns | | aegisx_patterns_suggest | Get pattern suggestions for a task |

Example:

Use aegisx_patterns_suggest with task="create API endpoint" to get relevant patterns.

API Contract Tools

| Tool | Description | | --------------------- | ------------------------------------------------------ | | aegisx_api_list | List all API endpoints, optionally filtered by feature | | aegisx_api_search | Search endpoints by keyword across paths and methods | | aegisx_api_get | Get detailed contract for a specific endpoint | | aegisx_api_validate | Validate implementation matches documented contracts |

Examples:

# List all endpoints
Use aegisx_api_list to see all documented APIs.

# Search for budget-related APIs
Use aegisx_api_search with query="budget" to find budget endpoints.

# Get contract details
Use aegisx_api_get with path="/api/profile" to see the full contract.

# Validate a feature
Use aegisx_api_validate with feature="user-profile" to check for mismatches.

API Testing & Authentication Tools

| Tool | Description | | -------------------------- | ------------------------------------------------------------- | | aegisx_auth_login | Login to API and store access token (default: localhost:3000) | | aegisx_auth_status | Check authentication status and token info | | aegisx_auth_decode_jwt | Decode JWT token to view header, payload, and expiry details | | aegisx_auth_logout | Logout and clear authentication session | | aegisx_api_request | Make authenticated HTTP requests (GET/POST/PUT/PATCH/DELETE) | | aegisx_api_history | View request/response history with filtering | | aegisx_api_clear_history | Clear request history |

Examples:

# Login to API
Use aegisx_auth_login with email and password to authenticate and store token.

# Check authentication status
Use aegisx_auth_status to see current user info and token expiry.

# Decode JWT token
Use aegisx_auth_decode_jwt to inspect token claims and expiration.

# Test protected endpoint
Use aegisx_api_request with method="GET" and path="/api/profile" to call authenticated endpoints.

# View request history
Use aegisx_api_history to see recent API calls with status codes and response times.

Features:

• ✅ Automatic token management and storage
• ✅ Request/response history (last 50 requests)
• ✅ JWT token decoding and validation
• ✅ Support for custom headers and query parameters
• ✅ Configurable base URL (default: http://localhost:3000)
• ✅ Environment variable support (AEGISX_API_URL)

Available Resources

| Resource | Description | | -------------------------------- | ------------------------------------------- | | aegisx://design-tokens | Design tokens (colors, spacing, typography) | | aegisx://development-standards | Coding standards and guidelines | | aegisx://api-reference | Backend API conventions | | aegisx://project-structure | Monorepo structure guide | | aegisx://quick-start | Getting started guide |

Component Categories

• data-display - Badge, Card, Avatar, KPI Card, Stats Card, List, Timeline, Progress
• forms - Date Picker, Input OTP, Knob, Popup Edit, Scheduler, Time Slots
• feedback - Alert, Loading Bar, Inner Loading, Splash Screen, Skeleton
• navigation - Breadcrumb, Command Palette, Navbar, Launcher
• layout - Classic Layout, Compact Layout, Enterprise Layout, Empty Layout
• auth - Login Form, Register Form, Reset Password Form, Social Login
• advanced - Calendar, Gridster, File Upload, Theme Builder, Theme Switcher
• overlays - Drawer

CRUD Packages

| Package | Features | | -------------- | ------------------------------------------- | | standard | Basic CRUD, pagination, search, soft delete | | enterprise | Standard + Excel/CSV import | | full | Enterprise + WebSocket events |

Development

Sync Data from Source

The sync tool automatically updates data files from source libraries. This runs before each build via the prebuild hook.

cd libs/aegisx-mcp
pnpm run sync           # Update data files
pnpm run sync:dry-run   # Preview changes without writing
pnpm run sync:verbose   # See detailed progress

Note: The sync process extracts component metadata from libs/aegisx-ui, command definitions from libs/aegisx-cli, and validates existing patterns. Manual edits to generated data files will be overwritten on next sync.

Build

cd libs/aegisx-mcp
pnpm install
pnpm run build

The build process automatically runs pnpm run sync before compilation to ensure data files are up to date.

Test Locally

node dist/index.js

Debug

Set DEBUG=mcp:* environment variable for verbose logging.

License

MIT