README.md•8.17 kB
# Magento 2 Development MCP Server
A Model Context Protocol (MCP) server for Magento 2 development, designed to integrate with AI agents like Claude, Cursor, Continue.dev, and Augment Code.
<img width="690" height="705" alt="image" src="https://github.com/user-attachments/assets/491e4f5d-d145-46b7-a509-56982508199a" />
## Installation
### Using npx
```bash
npx -y @elgentos/magento2-dev-mcp
```
## Quick Start
1. **Add to your AI agent's MCP configuration:**
```json
{
"mcpServers": {
"magento2-dev": {
"command": "npx",
"args": ["-y", "@elgentos/magento2-dev-mcp"]
}
}
}
```
2. **Restart your AI agent** to load the MCP server
3. **Start using Magento 2 development tools** through your AI agent!
See [AI Platform Configuration Examples](examples/ai-platform-configs.md) for platform-specific setup instructions.
## Features
## DI & Module Tools
<details>
<summary><strong>get-di-preferences</strong> - Get Magento 2 dependency injection preferences list</summary>
**Parameters:**
- `scope` (optional): The scope to get DI preferences for
- Options: `global`, `adminhtml`, `frontend`, `crontab`, `webapi_rest`, `webapi_soap`, `graphql`, `doc`, `admin`
- Default: `global`
**Available Scopes:**
- `global` - Global scope (default)
- `adminhtml` - Admin area
- `frontend` - Frontend/storefront area
- `crontab` - Cron job execution context
- `webapi_rest` - REST API context
- `webapi_soap` - SOAP API context
- `graphql` - GraphQL API context
- `doc` - Documentation context
- `admin` - Admin context (alternative to adminhtml)
</details>
<details>
<summary><strong>dev-module-list</strong> - List all Magento 2 modules and their status</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
- `enabled` (optional): Show only enabled modules
- `disabled` (optional): Show only disabled modules
</details>
<details>
<summary><strong>dev-module-observer-list</strong> - List all Magento 2 module observers</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
- `event` (optional): Filter by specific event name
</details>
<details>
<summary><strong>dev-theme-list</strong> - List all available Magento 2 themes</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
</details>
<details>
<summary><strong>dev-module-create</strong> - Create and register a new Magento 2 module</summary>
**Parameters:**
- `vendorNamespace` (required): Namespace (your company prefix)
- `moduleName` (required): Name of your module
- `minimal` (optional): Create only module file
- `addBlocks` (optional): Add blocks
- `addHelpers` (optional): Add helpers
- `addModels` (optional): Add models
- `addSetup` (optional): Add SQL setup
- `addAll` (optional): Add blocks, helpers and models
- `enable` (optional): Enable module after creation
- `modman` (optional): Create all files in folder with a modman file
- `addReadme` (optional): Add a readme.md file to generated module
- `addComposer` (optional): Add a composer.json file to generated module
- `addStrictTypes` (optional): Add strict_types declaration to generated PHP files
- `authorName` (optional): Author for readme.md or composer.json
- `authorEmail` (optional): Author email for readme.md or composer.json
- `description` (optional): Description for readme.md or composer.json
**Example Usage:**
```json
{
"name": "dev-module-create",
"arguments": {
"vendorNamespace": "MyCompany",
"moduleName": "CustomModule",
"addAll": true,
"enable": true,
"addReadme": true,
"addComposer": true,
"authorName": "John Doe",
"authorEmail": "john@example.com",
"description": "A custom Magento 2 module"
}
}
```
</details>
## System Diagnostics
<details>
<summary><strong>sys-info</strong> - Get Magento 2 system information</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
</details>
<details>
<summary><strong>sys-check</strong> - Check Magento 2 system requirements and configuration</summary>
**Parameters:** None
</details>
## Cache Management
<details>
<summary><strong>Cache Management Tools</strong> - Complete cache management suite</summary>
**Available Tools:**
- `cache-clean` - Clear specific or all caches
- `cache-flush` - Flush specific or all caches
- `cache-enable` - Enable specific cache types
- `cache-disable` - Disable specific cache types
- `cache-status` - Check cache status
- `cache-view` - Inspect cache entries
See [Cache Types Reference](docs/cache-types.md) for details.
</details>
## Configuration Management
<details>
<summary><strong>config-show</strong> - View Magento 2 system configuration values</summary>
**Parameters:**
- `path` (optional): Configuration path to show
- `scope` (optional): Configuration scope (default, website, store)
- `scopeId` (optional): Scope ID (website ID or store ID)
</details>
<details>
<summary><strong>config-set</strong> - Set Magento 2 system configuration values</summary>
**Parameters:**
- `path` (required): Configuration path to set
- `value` (required): Value to set
- `scope` (optional): Configuration scope
- `scopeId` (optional): Scope ID
- `encrypt` (optional): Encrypt the value
</details>
<details>
<summary><strong>config-store-get / config-store-set</strong> - Store-specific configuration management tools</summary>
Store-specific configuration management for getting and setting configuration values at the store level.
</details>
## Database Tools
<details>
<summary><strong>db-query</strong> - Execute SQL queries directly on Magento 2 database</summary>
**Parameters:**
- `query` (required): SQL query to execute
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
</details>
## Setup & Deployment
<details>
<summary><strong>setup-upgrade</strong> - Run Magento 2 setup upgrade to update database schema and data</summary>
**Parameters:**
- `keepGenerated` (optional): Keep generated files during upgrade
</details>
<details>
<summary><strong>setup-di-compile</strong> - Compile Magento 2 dependency injection configuration</summary>
**Parameters:** None
</details>
<details>
<summary><strong>setup-db-status</strong> - Check database status to see if setup:upgrade is needed</summary>
**Parameters:** None
</details>
<details>
<summary><strong>setup-static-content-deploy</strong> - Deploy Magento 2 static content and assets</summary>
**Parameters:**
- `languages` (optional): Languages to deploy
- `themes` (optional): Themes to deploy
- `jobs` (optional): Number of parallel jobs
- `force` (optional): Force deployment
</details>
## Store Management
<details>
<summary><strong>sys-store-list</strong> - List all Magento 2 stores, websites, and store views</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
</details>
<details>
<summary><strong>sys-store-config-base-url-list</strong> - List all base URLs for Magento 2 stores</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
</details>
<details>
<summary><strong>sys-url-list</strong> - Get all Magento 2 URLs</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
- `storeId` (optional): Store ID to filter URLs
</details>
<details>
<summary><strong>sys-website-list</strong> - List all Magento 2 websites</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
</details>
## Cron Management
<details>
<summary><strong>sys-cron-list</strong> - List all Magento 2 cron jobs and their configuration</summary>
**Parameters:**
- `format` (optional): Output format (`table`, `json`, `csv`) - Default: `table`
</details>
<details>
<summary><strong>sys-cron-run</strong> - Run Magento 2 cron jobs</summary>
**Parameters:**
- `job` (optional): Specific cron job to run
- `group` (optional): Cron group to run
</details>
## License
MIT License - see [LICENSE](LICENSE) file for details.