craftcms-claude-skills MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

Skill bundle for Craft CMS 5.x (PHP 8.2+) specifics
Templates for modules, plugins, custom fields
Twig template scaffolding that matches Craft idioms
Database migration patterns using Craft's MigrationHelper
GraphQL schema helpers for headless Craft projects

实时演示

实际使用效果

craftcms-claude-skill.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "craftcms-claude-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "craftcms-claude-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/michtio/craftcms-claude-skills",
          "~/.claude/skills/craftcms-claude-skills"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add craftcms-claude-skill -- git clone https://github.com/michtio/craftcms-claude-skills ~/.claude/skills/craftcms-claude-skills

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： craftcms-claude-skills

Scaffold a custom Craft CMS module without leaving Claude Code

👤 Craft CMS developers building site-specific modules ⏱ ~30 min intermediate

何时使用： You need a new module and don't want to hand-copy another one as a template.

前置条件

Craft CMS 5 project set up locally — composer create-project craftcms/craft my-project
Skill cloned — git clone https://github.com/michtio/craftcms-claude-skills ~/.claude/skills/craftcms-claude-skills

步骤

Describe the module's job

Use craftcms-claude-skills. Create a new module called 'Inventory' that registers a custom element type for warehouse items.✓ 已复制

→ Claude scaffolds modules/inventory/ with src/Inventory.php, elements/WarehouseItem.php, and a config entry
Wire it up

Register the module in config/app.php and add the bootstrap entry.✓ 已复制

→ Config diff shown; module loads without errors on craft setup/check
Add an element query

Add a WarehouseItemQuery class with a custom 'sku' parameter that filters on the content table.✓ 已复制

→ Query class with proper WHERE clauses, not raw SQL soup

结果： A working Craft module that follows Pixel & Tonic conventions — ready for your first migration.

注意事项

Claude writes Craft 3/4 style code — Explicitly state Craft CMS 5 in every prompt — the API surface changed

搭配使用： filesystem · mysql

Refactor a mess of Twig templates into idiomatic Craft

👤 Front-end devs inheriting a Craft site with sketchy templates ⏱ ~45 min intermediate

何时使用： You took over a Craft project and the templates are full of raw SQL, inline PHP, and cache tags that don't work.

步骤

Point Claude at the worst template

Using craftcms-claude-skills, review templates/_entries/blog.twig and rewrite it using proper element queries and {% cache %} tags.✓ 已复制

→ Refactored template with craft.entries, section handle, and correct cache scoping
Extract reusable macros

Pull the card markup into a macro in _macros/cards.twig and include it properly.✓ 已复制

→ Macro file created; includes use {% from %} syntax

结果： Templates that load faster and future devs can actually read.

注意事项

Cache tags wrap dynamic user data and show wrong content — Use {% cache %} with globally keyed variations, never around authenticated user data

搭配使用： filesystem

Write a safe Craft migration for content model changes

👤 Craft devs shipping schema changes to production ⏱ ~30 min advanced

何时使用： You're adding a new field or restructuring an existing one and need a migration that won't eat data.

步骤

Describe the change

Use craftcms-claude-skills. Write a Craft migration that adds a 'featuredAt' datetime field to the News section, with a safe backfill from postDate.✓ 已复制

→ Migration file with safeUp / safeDown; uses Craft's Fields service, not raw schema hacks
Dry-run in dev

Walk me through testing this with ./craft migrate/up --interactive=0 on a staging copy first.✓ 已复制

→ Step-by-step checklist including DB backup

结果： A migration you can ship on a Friday without panic.

注意事项

Forgetting to register the field type in project config — Always run craft project-config/write after the migration and commit the YAML

搭配使用： mysql · git

组合

与其他 MCP 搭配，撬动十倍杠杆

craftcms-claude-skill + filesystem

Skill provides Craft patterns; filesystem lets Claude actually apply them in your project

Apply the craftcms-claude-skills module scaffold to my current project directory.✓ 已复制

craftcms-claude-skill + mysql

Inspect Craft's content tables while writing migrations

Show me the current schema of the elements_sites table before I write this migration.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用
module_scaffold	module name, element types	Starting a new module
field_generator	field name, type, handle	Adding a custom field type
twig_refactor	template path	Cleaning up legacy templates

成本与限制

运行它的成本

API 配额: None
每次调用 Token 数: Moderate — reference files load on demand
费用: Free
提示: Reference the skill by name only when working on Craft code; it adds context overhead to unrelated tasks.

安全

权限、密钥、影响范围

凭据存储： No credentials

数据出站： None — local prompts and files only

Generated code targets Craft 5; do not apply to Craft 3/4 projects without review.

故障排查

常见错误与修复

Claude generates Craft 3-era code (craft()->elements)

Mention 'Craft CMS 5' explicitly; the API namespace is craft\elements in 5.x

验证： grep -r 'craft()->' src/ should return nothing in Craft 5 code

Migration runs but field doesn't appear in CP

Run ./craft project-config/write and ./craft project-config/apply — project config drift is the usual cause

验证： ./craft project-config/diff

Skill not triggered on Craft prompts

Invoke by name: 'use craftcms-claude-skills'. Check SKILL.md is present.

验证： ls ~/.claude/skills/craftcms-claude-skills/SKILL.md

替代方案

craftcms-claude-skills 对比其他方案

替代方案	何时用它替代	权衡
Raw Claude Code	Simple Twig-only tweaks that don't need Craft-specific idioms	Generic PHP suggestions, often wrong for Craft
symfony-hexagonal-skill	You're on Symfony, not Craft	Different framework conventions

craftcms-claude-skills

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： craftcms-claude-skills

Scaffold a custom Craft CMS module without leaving Claude Code

前置条件

步骤

注意事项

Refactor a mess of Twig templates into idiomatic Craft

步骤

注意事项

Write a safe Craft migration for content model changes

步骤

注意事项

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

craftcms-claude-skills 对比其他方案

更多

资源