InstantCMS MCP服务器
MCP（Model Context Protocol）用于开发附加组件和模板的服务器 即时CMS 2.
通过将此服务器连接到AI助手（Claude、Cursor等），您将获得完整的系统上下文-钩、类API、文件结构-并可以从第一个请求创建工作扩展。
______________________________________________________________________
机会
- 102 胡克 描述参数、类型和现成的实现示例
- 170事件 从cms_events表
- 38核心类 （cmsModel，cmsTemplate，cmsDatabaseидр.）500+методами
- 斯卡福德振荡 -一次呼叫所有附加文件
- 50个数据库表 完整电路
- 61控制器 809个动作
- 120个辅助功能 （模板、html、文件、字符串）
- 6 PHP类 （Jevix、谷歌认证、移动检测、RSS、IDNA、YAML）
- 结构验证 附录
- 搜索钩 按名称、描述、类别
- 代码示例 标准任务
______________________________________________________________________
安装
要求
- Node.js 18+
- npm
克隆和组装
git clone https://github.com/your-username/instantcms-mcp.git
cd instantcms-mcp
npm install
npm run build连接Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"instantcms": {
"command": "node",
"args": ["/absolute/path/to/instantcms-mcp/dist/index.js"]
}
}
}重新启动Claude Desktop。带前缀的工具将出现在聊天中 instantcms.
连接到Cursor/其他MCP客户端
{
"mcp": {
"servers": {
"instantcms": {
"command": "node",
"args": ["/absolute/path/to/instantcms-mcp/dist/index.js"]
}
}
}
}启动检查员（调试）
npm run inspector______________________________________________________________________
工具（38）
基本（14）
tool描述 |------|---------| | get_addon_structure –附加文件的结构（5种类型）。 | scaffold_addon 生成所有文件的完整代码。 | list_hooks 过滤的钩子列表 | get_hook_details –胡克细节+实现示例→ | search_hooks 全文搜索胡克 | get_component_api –类API（cmsmodel、cmstemplate等）。 | list_components 列出所有组件。 | validate_addon 补充结构验证 | get_field_types 形状的字段类型 | get_code_example 示例任务代码。 | scaffold_template 生成主题模板 | get_template_structure 结构与模式变量 | scaffold_layout_scheme –Modern的小部件方案→ | list_layout_presets 停止方案。
静态数据库（6）
tool描述 |------|---------| | introspect_database 数据库列表 | describe_table 表的结构 | list_content_types 内容类型 | list_database_events 事件地图 | analyze_controller 控制器分析 | list_controllers 控制器列表
MariaDB-动态（6）
tool描述 |------|---------| | maria_execute_query SQL查询 | maria_list_tables 表列表 | maria_describe_table 表的结构 | maria_get_database_info BD统计 | maria_search_tables 搜索表 | maria_get_table_data 数据来自Paginia。
源代码（6）
tool描述 |------|---------| | list_widgets 小部件列表 | get_widget_info 小部件的细节 | list_traits 崔特名单 | get_trait_info 特雷特的方法 | list_field_types 田野类型 | get_field_type_info 田野的细节
移徙（2）
tool描述 |------|---------| | generate_migration 生成SQL和Install.php | get_field_suggestions 字段提示 |
人工智能分析（2）
tool描述 |------|---------| | analyze_requirement ，分析请求。 | suggest_addon_structure 结构类型
______________________________________________________________________
资源（4）
| URI |
|---|
instantcms://hooks/all 所有的胡克（JSON） |
instantcms://components/all 所有组件（JSON） |
instantcms://addon/types 添加类型（JSON） |
instantcms://quickstart 《Markdown（英语：Markdown）》 |
______________________________________________________________________
使用示例
从零创建补充
Создай дополнение для отображения каталога товаров с категориями,
админ-панелью для управления, виджетом последних добавлений
и интеграцией с поиском сайта找到正确的钩子
Какой хук использовать, чтобы добавить вкладку на страницу профиля пользователя?实现钩
Напиши реализацию хука content_after_add_approve, который добавляет
уведомление в нашу кастомную систему нотификаций处理API
Как правильно использовать cmsModel для постраничного вывода
с несколькими JOIN и сортировкой?______________________________________________________________________
项目结构
src/
├── data/
│ ├── hooks.ts # 102 хука по 17 категориям
│ ├── components.ts # API базовых классов
│ ├── core-api.ts # 38 классов ядра с методами
│ ├── libs-api.ts # Хелперы, классы, сторонние библиотеки
│ ├── js-api.ts # JavaScript API для фронтенда
│ ├── database-schema.ts # 50 таблиц БД
│ ├── events-map.ts # 170 событий
│ ├── controllers-map.ts # 61 контроллер, 809 экшенов
│ ├── traits-map.ts # 10 трейтов, 56 методов
│ ├── fields-map.ts # 32 типа полей
│ ├── widgets-map.ts # 4 виджета
│ └── schemas.ts # Структуры дополнений
├── tools/
│ ├── hooks-tool.ts # list / get / search хуков
│ ├── addon-tool.ts # структура, API, валидация
│ ├── scaffold-tool.ts # генерация файлов
│ ├── layout-tool.ts # схемы виджетов
│ ├── db-tool.ts # статические данные БД
│ ├── controllers-tool.ts # контроллеры
│ ├── source-tool.ts # виджеты, трейты, поля
│ ├── migration-tool.ts # миграции
│ ├── requirement-tool.ts # AI анализ
│ └── parser/ # Парсеры данных
├── server.ts # 38 инструментов + 4 ресурса
└── index.ts # Точка входа______________________________________________________________________
附录类型
类型描述 |-----|----------| | basic 只有前锋。 | with_admin 首页+crud在admin | with_hooks 通过胡克整合 | with_routes 自定义URL路由 | with_widget 小部件
______________________________________________________________________
系统/libs库
辅助功能（120）
模块描述 |--------|--------|---------| Ðtemplate.helperÐ28ÐÐÐÐÐÐÐÐÐÐ Ðhtml.helperÐÐÐÐÐÐÐÐÐÐÐ Ðfiles.helperÐÐÐÐÐÐÐÐÐÐÐ Ðstrings.helperÐÐÐÐÐÐÐÐÐÐÐÐ
PHP类（6）
班级，目的地。 |-------|------------| ÐJEVIXÐXSS过滤，HTML/XML解析器› |谷歌身份验证器|谷歌身份验证器2FA| Ðmobileu detectÐmobileu detectÐmobileu detectÐmobileu detectÐ |最新RSS| |idna_convert | IDN Unicode/Punycode| | spyc | YAML 解析器 |
外部（3）
图书馆，目的地 |------------|------------| SCSSPHP/SASS编译器 ÐÐÐÐÐÐÐÐÐÐÐÐÐ phpmailer发送电子邮件
______________________________________________________________________
开发
# Установка зависимостей
npm install
# Режим наблюдения (hot reload)
npm run dev
# Пересборка
npm run build
# Тесты (71 тест)
npm test
# Парсинг данных
npm run parse:all______________________________________________________________________
相容性
- 即时CMS：2.x
- Node.js: 18+
- MCP-SDK：@modelcontextprotocol/sdk^1.0
______________________________________________________________________
统计
度量值 |---------|----------| MCP工具 38 | MCP资源 4 | 测试。 71 | SQL表 50 | 胡克 102 | 事件。 170 | 控制器 61 | 行动 809 | 核心类 38 | 小部件 4 | 崔泰 10 | 田野类型 32 | Helper功能 120 | PHP类 6 |
______________________________________________________________________
许可证
麻省理工学院