Download the PHP package stimmt/craft-mcp without Composer
On this page you can find all versions of the php package stimmt/craft-mcp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download stimmt/craft-mcp
More information about stimmt/craft-mcp
Files in stimmt/craft-mcp
Package craft-mcp
Short Description MCP (Model Context Protocol) server for Craft CMS
License MIT
Homepage https://stimmt.digital
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package craft-mcp
Introduction
Craft MCP accelerates AI-assisted development by giving your AI assistant direct access to your Craft installation's content architecture, database schema, and configuration.
At its foundation, Craft MCP is an MCP server equipped with 50 specialized tools, 9 analysis prompts, and 12 data resources designed to streamline AI-assisted workflows in Craft projects. Rather than manually describing your field layouts, Matrix configurations, or entry structures, your AI assistant can query this information directly from your installation, ensuring accurate and context-aware code generation.
The tools span content management (entries, assets, categories, users), schema inspection (sections, fields, volumes, entry types), system administration (configuration, logs, caches, plugins), database operations (schema inspection, query execution), and debugging utilities (queue jobs, deprecations, project config). For advanced use cases, a Tinker tool allows executing PHP code directly within your Craft application context.
Installation
Craft MCP can be installed via Composer:
Next, install the plugin through Craft's CLI:
Then create a configuration file at config/mcp.php to enable the MCP server. By default, the server is disabled in production environments for security:
For additional configuration options including disabling specific tools, IP allowlists, and environment-specific settings, see the Configuration Guide.
Once Craft MCP has been installed, you're ready to connect Claude Code, Cursor, Claude Desktop, or your AI assistant of choice.
Quick Setup (Recommended)
Run the interactive configuration wizard to automatically generate config files for your MCP clients:
The wizard will:
- Detect your environment (DDEV or native PHP)
- Let you select which clients to configure (Claude Code, Cursor, Claude Desktop)
- Generate the appropriate configuration files
Options:
-e, --environment- Override detected environment (ddevornative)-s, --serverName- Custom server name (default:craft-cms)
Manual Setup
Claude Code
- Create a new file called
.mcp.jsonin your Craft project root - Add the server configuration based on your local environment:
With DDEV (recommended for Craft projects)
Without DDEV (native PHP)
Cursor
- Create a new file called
.cursor/mcp.jsonin your Craft project root (create the.cursordirectory if it doesn't exist) - Add the server configuration based on your local environment:
With DDEV (recommended for Craft projects)
Without DDEV (native PHP)
Claude Desktop
- Open your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Add the server configuration. Unlike Claude Code and Cursor, Claude Desktop requires absolute paths for both the command and working directory:
With DDEV (recommended for Craft projects)
Without DDEV (native PHP)
You can find your absolute paths by running which ddev or which php in your terminal.
Remote Server via SSH (Not Recommended)
For development environments on remote servers, you can tunnel through SSH. Note that this approach is not recommended for production use due to security considerations.
SSH tunnel configuration
Requirements: - SSH key authentication must be configured (no password prompts) - The remote server must have PHP 8.2+ available - The Craft MCP plugin must be installed on the remote installationAvailable MCP Tools
Content Tools
| Name | Notes |
|---|---|
| List Entries | Query entries with filtering by section, status, author, and limit |
| Get Entry | Retrieve full entry details including all custom field values |
| Create Entry | Create new entries in any section with field data |
| Update Entry | Modify existing entry content and custom fields |
| List Assets | Browse assets with volume and folder filtering |
| Get Asset | Get detailed asset information including dimensions and metadata |
| List Asset Folders | List folder structure within asset volumes |
| List Categories | Query categories by group with hierarchy information |
| List Users | Query users with group filtering |
| List Globals | List all global sets with their field values |
Schema & Structure Tools
| Name | Notes |
|---|---|
| List Sections | Inspect all sections with their entry types and field layouts |
| List Fields | Get all fields with types, settings, and group assignments |
| List Volumes | Inspect asset volume configurations and filesystem settings |
| List Plugins | Get installed plugins with version, status, and settings |
System Tools
| Name | Notes |
|---|---|
| Get System Info | Read Craft version, PHP version, database driver, and environment |
| Get Config | Read Craft general config and plugin configuration values |
| Read Logs | Search and filter log entries by level, source, pattern, with text or JSON output |
| Get Last Error | Retrieve the most recent error from logs |
| Clear Caches | Clear specific caches or all caches at once |
| List Routes | Inspect all registered routes including controller actions |
| List Console Commands | List available Craft CLI commands |
Database Tools
| Name | Notes |
|---|---|
| Get Database Info | Get database connection details and server version |
| Get Database Schema | Inspect the complete database schema with all tables and columns |
| Get Table Counts | Get row counts for core Craft tables |
| Run Query | Execute read-only SELECT queries against the database |
Debugging Tools
| Name | Notes |
|---|---|
| Get Queue Jobs | Inspect queue jobs by status (pending, reserved, failed, done) |
| Get Project Config Diff | Show pending project config changes that need to be applied |
| Get Deprecations | Read deprecation warnings from logs and the deprecations table |
| Explain Query | Run EXPLAIN on queries for performance analysis |
| Get Environment | Read safe environment information (no secrets exposed) |
| List Event Handlers | Inspect registered Yii event handlers and listeners |
| Tinker | Execute arbitrary PHP code within your Craft application context |
Multi-Site Tools
| Name | Notes |
|---|---|
| List Sites | Get all sites with handles, languages, and base URLs |
| Get Site | Get detailed site information by ID or handle |
| List Site Groups | List site groups with their associated sites |
GraphQL Tools
| Name | Notes |
|---|---|
| List GraphQL Schemas | List all GraphQL schemas with their scopes |
| Get GraphQL Schema | Get schema details including SDL |
| Execute GraphQL | Run GraphQL queries and mutations |
| List GraphQL Tokens | List API tokens with their associated schemas |
Backup Tools
| Name | Notes |
|---|---|
| List Backups | List available database backups |
| Create Backup | Create a new database backup |
Self-Awareness Tools
| Name | Notes |
|---|---|
| Get MCP Info | Get plugin version, status, and configuration |
| List MCP Tools | List all available tools with descriptions and enabled status |
| Reload MCP | Reload to detect newly installed plugins without server restart |
Commerce Tools (when Craft Commerce is installed)
| Name | Notes |
|---|---|
| List Products | List products with variant information |
| Get Product | Get detailed product information |
| List Orders | List orders with status filtering |
| Get Order | Get order details by ID or number |
| List Order Statuses | List available order statuses |
| List Product Types | List product type configurations |
Extending
Other Craft plugins and modules can register their own MCP tools by listening to the EVENT_REGISTER_TOOLS event. This allows you to expose plugin-specific functionality to AI assistants, such as custom element types, module APIs, or specialized queries.
See the Extending Guide for implementation details, code examples, and best practices for tool development.
Documentation
- Installation - Requirements, Composer setup, and detailed installation steps
- Configuration - All configuration options, environment variables, and security settings
- Tools Reference - Complete documentation for all 50 tools with parameters and examples
- Prompts - Pre-built analysis prompts for content health, audits, and schema exploration
- Resources - Read-only URI-based access to schema, config, and content data
- Extending - Guide for plugin and module developers to register custom tools, prompts, and resources
Contributing
Thank you for considering contributing to Craft MCP! Please see GitHub Issues for bug reports, feature requests, and discussion.
Credits
- Created and maintained by Max van Essen
- Inspired by Laravel Boost
- Plugin icon from Lucide (MIT)
License
Craft MCP is open-sourced software licensed under the MIT license.
