Warden MCP Server

🚀 Warden Magento MCP 服务器

这是一个全面的模型上下文协议（MCP）服务器，可实现 AI 助手与 Warden + Magento 2 开发环境的无缝集成。该服务器使 AI 助手能够直接与由 Warden 管理的 Magento 项目进行交互，自动执行常见的开发任务，并为复杂的工作流程提供智能辅助。

✨ 主要特性

此 MCP 服务器通过以下功能，将您的 AI 助手转变为 Warden + Magento 2 项目强大的开发伙伴：

• 🚀 项目初始化：创建具有可定制 Magento 2 环境的新 Warden 项目。
• 🔧 环境管理：通过智能状态管理启动/停止项目和服务。
• 🗄️ 数据库操作：直接在容器化数据库中执行 SQL 查询。
• 🐘 PHP 开发工具：在配置完善的容器化环境中运行 PHP 脚本。
• 🛠️ Magento CLI 集成：在容器内无缝执行 Magento 命令。
• 🧪 单元测试支持：通过自动检测配置运行 PHPUnit 测试。
• 📦 Composer 集成：在容器内通过完整的命令支持管理依赖项。
• 📊 环境监控：列出并监控正在运行的 Warden 环境。

📦 安装指南

1. 克隆或下载此仓库。
2. 安装依赖项：

npm install

3. 配置您的 MCP 客户端（请参阅下面的“配置”部分）。

📚 详细文档

MCP 客户端配置

将以下配置添加到您的 MCP 客户端设置中：

{
  "mcpServers": {
    "warden-magento": {
      "command": "node",
      "args": ["/absolute/path/to/warden-mcp-server/server.js"],
      "env": {}
    }
  }
}

重要提示：请将 /absolute/path/to/warden-mcp-server/server.js 替换为您系统上 server.js 文件的实际绝对路径。

针对 Claude Desktop

添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "warden-magento": {
      "command": "node",
      "args": ["/Users/your-username/path/to/warden-mcp-server/server.js"]
    }
  }
}

针对 Zed 编辑器

添加到您的 Zed 设置中：

{
  "assistant": {
    "version": "2",
    "provider": {
      "name": "anthropic",
      "model": "claude-3-5-sonnet-20241022"
    }
  },
  "context_servers": {
    "warden-magento": {
      "command": "node",
      "args": ["/Users/your-username/path/to/warden-mcp-server/server.js"]
    }
  }
}

💻 使用示例

配置完成后，您的 AI 助手可以自动使用这些工具来协助进行 Warden + Magento 开发任务。只需描述您想要完成的任务，AI 就会使用相应的工具。

可用工具

环境管理

项目初始化

数据库操作

PHP 开发

Magento CLI

测试

依赖管理

先决条件

• Warden：必须在您的系统上安装并配置。
• Docker：Warden 正常运行所需。
• Node.js：版本 18.0.0 或更高。
• MCP 客户端：兼容的 MCP 客户端（Claude Desktop、Zed 等）。

故障排除

对于此 MCP 服务器的特定问题，请检查：

• 运行 npm start 时的服务器日志。
• MCP 客户端日志以排查连接问题。
• Docker 容器日志：warden env logs。
• MCP 服务器检查器：https://github.com/modelcontextprotocol/inspector

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

贡献

欢迎贡献代码！请随时提交问题和拉取请求。

相关项目

• Warden - 基于 Docker 的开发环境。
• Model Context Protocol - 协议规范。
• Magento 2 - 电子商务平台。