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 - 電子商務平臺。