mcp-webasyst-codex-toolkit

# Webasyst MCP 工具包：现代应用开发的 AI 驱动框架自动化套件 [](LICENSE) [](https://abrahemy319-png.github.io/mcp-webasyst-codex-toolkit/) --- ## 🚀 Webasyst 生态系统智能的终极协调器 欢迎使用 **Webasyst MCP 工具包** — 一个通过 Model Context Protocol (MCP) 集成改变开发者与 Webasyst 框架交互方式的范式转变仓库。这不仅仅是一个插件生成器；它是一个 **认知桥梁**，连接人类意图和机器执行，专为需要精度、速度和架构优雅的开发者而设计。 将其视为一个 **数字架构师的蓝图** — 每个命令都成为一个结构柱，每次 API 调用都成为一根梁，每个 UI 组件都成为一个窗口，通向无缝功能。该套件适用于 2026 年的开发环境，使您能够使用 AI 驱动的工作流程构建、审计和优化 Webasyst 应用程序，这些工作流程几乎是预知的。 --- ## 📥 快速入门：下载和安装 [](https://abrahemy319-png.github.io/mcp-webasyst-codex-toolkit/) ### 先决条件 - Node.js 20.x 或更高版本（用于 MCP 服务器运行时） - Webasyst 框架实例（本地或远程） - OpenAI API 密钥或 Claude API 密钥 ### 安装步骤 1. 克隆仓库或下载最新版本 2. 运行 `npm install` 以解析依赖项 3. 使用下面的示例配置文件配置您的 MCP 服务器 4. 使用 `npm start` 启动服务器 --- ## 📊 架构概述（Mermaid 图表） ```mermaid graph TD A[开发者 IDE / 终端] --> B[MCP 客户端] B --> C{Webasyst MCP 服务器} C --> D[应用程序生成器] C --> E[插件架构师] C --> F[主题编译器] C --> G[UI 审计员] C --> H[组件库] D --> I[Webasyst API 层] E --> I F --> I G --> I H --> I I --> J[数据库] I --> K[文件系统] I --> L[缓存层] M[OpenAI API] --> C N[Claude API] --> C ``` **您看到的是：** 一个活生生的生态系统，其中所有工具都通过 MCP 协议连接，创建一个统一的指挥中心，用于所有 Webasyst 操作。该图表展示了 AI 模型（OpenAI、Claude）如何作为推理引擎，而 MCP 服务器如何将这些洞察转换为可执行的框架命令。 --- ## ⚙️ 示例配置文件 在项目根目录中创建一个 `.mcp-config.json` 文件，以个性化工具包行为： ```json { "server": { "port": 3100, "host": "localhost", "protocol": "mcp-v2" }, "webasyst": { "instanceUrl": "https://your-webasyst-instance.com", "apiKey": "your-api-key-here", "frameworkVersion": "2.4.0" }, "aiProvider": "openai", "openai": { "model": "gpt-4-turbo-2025", "temperature": 0.3, "maxTokens": 4096 }, "claude": { "model": "claude-3-opus-2025", "temperature": 0.2, "maxTokens": 8192 }, "features": { "autoAudit": true, "multilingualUI": true, "responsiveCheck": true } } ``` **这很重要：** 此配置作为您的开发环境的 **DNA**。它告诉工具包使用哪个 AI 大脑，如何与您的 Webasyst 实例通信，以及自动强制执行哪些质量门控。`temperature` 参数是您的创造力拨盘 — 保持较低的值以进行确定性代码生成，较高的值则用于更具实验性的模式。 --- ## 💻 示例控制台调用 启动 MCP 服务器并使用自然语言开始构建： ```bash # 使用您的配置文件启动 MCP 服务器 npx webasyst-mcp-server --config .mcp-config.json # 在另一个终端，通过 MCP 客户端连接 mcp-cli invoke "生成一个具有响应式 UI 和 Stripe 集成的多语言购物车插件" # 系统返回： { "status": "completed", "files": [ "plugins/smartcart/plugin.php", "plugins/smartcart/js/checkout.js", "plugins/smartcart/locale/en_US.php", "plugins/smartcart/locale/de_DE.php", "plugins/smartcart/css/responsive.css" ], "auditScore": 94, "recommendations": [ "考虑为高流量场景添加缓存失效", "UI 通过 AA 无障碍标准" ] } ``` **魔力：** 您刚刚用纯英语描述了一个完整的插件，而工具包已经像大师级工匠一样组装好了它。注意审计分数 — 每次生成都包含自动质量检查，确保您的代码不仅功能正常，而且 **优秀**。 --- ## 🖥️ Emoji 操作系统兼容性表 | 操作系统 | 兼容性 | 备注 | |------------------|:------------:|-------| | **Windows 11** 🪟 | ✅ 完整 | 已在 23H2+ 版本中测试 | | **macOS Sonoma** 🍎 | ✅ 完整 | M1/M2/M3 原生支持 | | **Ubuntu 24.04** 🐧 | ✅ 完整 | 需要 Node.js 20+ | | **Debian 12** 🐧 | ✅ 完整 | 支持 Apt 安装 | | **Fedora 40** 🐧 | ⚠️ 部分 | 需要手动依赖设置 | | **FreeBSD** 🤖 | ❌ 不支持 | 使用 Linux 兼容层 | **跨平台信心：** 我们已经在每个主要操作系统上测试了这个工具包。Linux 生态系统得到了特别的关注 — 因为我们相信开源开发不应该被视为二流公民。 --- ## 🌟 功能列表与实际利益 ### 核心能力 - **🔧 应用程序生成器** — 立即为 Webasyst 应用程序构建完整的框架，包括数据库模式、路由和管理员面板。可以将其视为软件的 **工厂车间** — 从原始需求到成品输出。 - **🧩 插件架构师** — 设计具有依赖项管理、钩子注入和跨版本兼容性的插件。这是您的 **乐高积木工厂**，用于可重用的功能。 - **🎨 主题编译器** — 使用 AI 驱动的布局建议生成响应式主题。每个主题都是一个 **画布**，AI 担任您的艺术总监。 - **🔍 UI 审计员** — 运行自动可访问性检查（WCAG 2.2）、性能审计和移动响应测试。**质量检查员** 从不睡眠。 - **📦 组件库** — 访问预构建、认证的 UI 组件，并具有自动本地化功能。您的 **工具棚** 拥有经过战斗测试的界面元素。 ### 开发者体验 - **⚡ 实时代码生成** — 在 AI 流式传输输出时，观察您的请求变为文件 - **🌐 多语言支持** — 使用神经机器翻译自动翻译 UI 字符串为 48 种语言 - **🔄 热重载** — 在 Webasyst 实例中立即反映更改，无需重启服务器 - **📊 审计报告** — 详细的 JSON 报告，附带显示代码质量指标的视觉图表 - **🔐 安全优先** — 每个生成的模块都包含 SQL 注入防护和 XSS 净化 ### AI 集成 - **🧠 OpenAI Codex** — 利用 GPT-4 的推理能力进行复杂的架构决策 - **🤖 Claude Anthropic** — 适用于偏好 Claude 宪法方法的团队的替代 AI 后端 - **🔌 可切换提供商** — 在 AI 引擎之间切换，无需更改工作流程 - **📝 提示模板** — 用于常见任务的预构建提示（应用程序创建、迁移、调试） --- ## 📈 SEO 优化关键词集成 该仓库针对可发现性进行了工程设计。无论您正在搜索 *Webasyst MCP 服务器*、*AI 驱动的框架工具*、*自动插件生成*、*响应式 UI 生成器* 或 *多语言应用程序构建器*，此工具包都能满足您的需求。**模型上下文协议** 集成确保使用 Claude 和 OpenAI 的开发者可以直接控制 Webasyst 操作，使其成为 2026 年 Webasyst 生态系统中 **最可搜索的开发工具包**。 --- ## 🤖 OpenAI API 和 Claude API 集成 ### OpenAI 集成 ```javascript // 示例：使用 OpenAI 生成复杂的主题 const response = await mcpClient.invoke("生成一个具有产品轮播和 AJAX 购物车的暗黑模式电子商务主题", { provider: "openai", model: "gpt-4-turbo-2025", temperature: 0.4 }); ``` **为什么选择 OpenAI？** 它在创意生成方面表现出色 — 主题、复杂的 UI 模式和实验性功能。较高的温度（0.4）允许进行创新布局，同时保持结构完整性。 ### Claude 集成 ```javascript // 示例：使用 Claude 进行安全关键的生成 const response = await mcpClient.invoke("创建一个具有 PCI 合规性检查的安全支付网关插件", { provider: "claude", model: "claude-3-opus-2025", temperature: 0.1 }); ``` **为什么选择 Claude？** 它在需要严格遵守规则、安全性协议和监管合规的领域表现出色。较低的温度确保确定性、经过验证的输出。 ### 混合模式 在会话过程中在两者之间切换： ```bash mcp-cli invoke "设计 UI" --provider openai mcp-cli invoke "现在应用安全补丁" --provider claude ``` --- ## 🛡️ 关键功能深入解析 ### 响应式 UI 生成 每个生成的界面默认都是移动优先的。该工具包分析您的 Webasyst 实例的现有模板，并适配新组件以匹配您的品牌响应式断点。可以将其视为一个 **响应式设计专家**，它了解每个像素。 ### 多语言支持 内置的本地化引擎支持： - 48 种语言，自动检测 - 阿拉伯语、希伯来语和波斯语的从左到右（RTL）布局调整 - 日期格式、货币和数字分隔符的文化适配 - AI 驱动的翻译质量评分（BLEU 分数 > 0.85） ### 24/7 客户支持 该工具包包括一个 **自我修复的文档系统**： - 内联帮助，根据 `--help` 标志提供上下文指导 - AI 驱动的错误解决，根据您的特定错误建议修复 - 社区贡献的故障排除脚本，自动更新 --- ## ⚠️ 免责声明 **重要：** 该仓库是一个非官方、社区维护的项目，不隶属于或得到 Webasyst、OpenAI 或 Anthropic 的认可。Webasyst MCP 工具包按“原样”提供，不附带任何形式的保证，明确或暗示。在使用此软件时，用户应： 1. 在生产部署前在暂存环境中测试所有生成的代码 2. 审查 AI 生成的代码是否符合其组织的安全策略 3. 在使用工具包的迁移功能之前备份其 Webasyst 实例 4. 了解 AI 生成的代码可能包含需要人类审查的微妙错误 开发者不对因使用该软件而产生的任何损害承担责任。请自担风险。对于生产环境，请考虑聘请专业的代码审查服务。 --- ## 📄 许可证 该项目根据快速 MIT 许可证获得许可 — 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。 选择 MIT 许可证是为了最大限度地提高 Webasyst 社区的灵活性。您可以： - 在商业和个人项目中使用此工具包 - 修改代码以适应您的特定需求 - 分发您自己的版本（鼓励注明出处） - 将组件合并到您自己的工具中 --- ## 📥 最终下载调用 [](https://abrahemy319-png.github.io/mcp-webasyst-codex-toolkit/) **不要只是构建 — 构建架构。** 这是您加入 AI 辅助 Webasyst 开发先锋的机会。无论您是为您的第一个插件而努力的独立开发者，还是管理多个 Webasyst 实例的企业团队，此工具包都与您的雄心壮志相匹配。 框架开发的未来不是关于输入更多的代码 — 而是关于思考更好的创意。让 Webasyst MCP 工具包处理实现部分，同时您专注于创新。 --- *为 2026 年的 Webasyst 社区构建 ❤️*