Warden MCP Server

🚀 Warden Magento MCP Server

このModel Context Protocol (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 Editor用

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が適切なツールを使用します。

基本的な使用法

以下に、各機能の使用例を示します。

環境管理

warden_list_environments

すべての実行中のWarden環境を、そのディレクトリとステータス情報とともに一覧表示します。

パラメーター：なし

使用例：

• 現在実行中の環境を確認します。
• 他の操作のためにプロジェクトパスを取得します。
• 環境のステータスを監視します。

warden_start_project

Wardenプロジェクト環境を起動し、すべての構成されたコンテナを起動します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス

使用例：

• 開発環境を起動します。
• プロジェクトの作業を再開します。
• システム再起動後にサービスを起動します。

warden_stop_project

Wardenプロジェクト環境を停止し、すべてのプロジェクトコンテナをシャットダウンします。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス

使用例：

• 開発環境をクリーンにシャットダウンします。
• システムリソースを解放します。
• システムメンテナンスの準備をします。

warden_start_svc

Wardenシステムサービス（DNS、プロキシなどの共有インフラストラクチャ）を起動します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス

使用例：

• Wardenインフラストラクチャを初期化します。
• システム再起動後に共有サービスを起動します。
• プロジェクト起動のために環境を準備します。

warden_stop_svc

Wardenシステムサービスを停止します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス

使用例：

• Wardenインフラストラクチャをクリーンにシャットダウンします。
• サービスの競合をトラブルシューティングします。
• システムメンテナンスを行います。

プロジェクト初期化

warden_init_project

完全に構成されたMagento 2環境で新しいWardenプロジェクトを初期化します。

パラメーター：

• project_path（必須）：プロジェクトを初期化するパス
• project_name（必須）：Warden環境の名前
• environment_type（オプション）：環境タイプ（デフォルト："magento2"）
• php_version（オプション）：PHPバージョン（デフォルト："8.3"）
• mysql_distribution（オプション）：MySQLディストリビューション（デフォルト："mariadb"）
• mysql_version（オプション）：MySQLバージョン（デフォルト："10.6"）
• node_version（オプション）：Node.jsバージョン（デフォルト："20"）
• composer_version（オプション）：Composerバージョン（デフォルト："2"）
• opensearch_version（オプション）：OpenSearchバージョン（デフォルト："2.12"）
• redis_version（オプション）：Redisバージョン（デフォルト："7.2"）
• enable_redis（オプション）：Redisを有効にする（デフォルト：true）
• enable_opensearch（オプション）：OpenSearchを有効にする（デフォルト：true）
• enable_varnish（オプション）：Varnishを有効にする（デフォルト：true）
• enable_rabbitmq（オプション）：RabbitMQを有効にする（デフォルト：true）
• enable_xdebug（オプション）：Xdebugを有効にする（デフォルト：true）

使用例：

• 新しいMagento 2開発環境をセットアップします。
• 特定のPHP/MySQLバージョンでプロジェクトを作成します。
• 特定の要件に合わせて環境を構成します。
• カスタムサービススタックでプロジェクトを初期化します。

データベース操作

warden_db_query

Wardenデータベースコンテナ内で直接SQLクエリを実行します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス
• query（必須）：実行するSQLクエリ
• database（オプション）：データベース名（デフォルト："magento"）

使用例：

• デバッグのためにデータベースクエリを実行します。
• 分析のためにデータを取得します。
• データベースのメンテナンスタスクを実行します。
• データベースのスキーマまたはデータを確認します。

PHP開発

warden_php_script

適切な環境設定でphp-fpmコンテナ内でPHPスクリプトを実行します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス
• script_path（必須）：プロジェクトルートからのPHPスクリプトへのパス
• args（オプション）：スクリプトに渡す追加の引数

使用例：

• カスタムPHPスクリプトを実行します。
• データ移行スクリプトを実行します。
• PHPの機能をテストします。
• メンテナンススクリプトを実行します。

Magento CLI

warden_magento_cli

php-fpmコンテナ内でMagento CLIコマンドを実行します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス
• command（必須）：Magento CLIコマンド（'bin/magento' 接頭辞なし）
• args（オプション）：コマンドの追加引数

使用例：

• キャッシュ操作（cache:clean、cache:flush）を実行します。
• セットアップコマンド（setup:upgrade、setup:di:compile）を実行します。
• 設定を管理します（config:set、config:show）。
• インデックス操作（indexer:reindex）を実行します。
• モジュール管理（module:enable、module:disable）を行います。

テスト

warden_run_unit_tests

自動構成検出でphp-fpmコンテナ内でPHPUnitテストを実行します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス
• config_file（オプション）：PHPUnit構成ファイル（phpunit.xml.distまたはphpunit.xmlを自動検出）
• test_path（オプション）：特定のテストファイルまたはディレクトリへのパス
• extra_args（オプション）：追加のPHPUnit引数

使用例：

• モジュールの単体テストを実行します。
• 特定のテストスイートを実行します。
• カスタム構成でテストを実行します。
• 自動テストでコードの変更を検証します。

依存関係管理

warden_composer

php-fpmコンテナ内でComposerコマンドを実行します。

パラメーター：

• project_path（必須）：プロジェクトディレクトリへのパス
• command（必須）：実行するComposerコマンド

一般的なコマンド：

• install - 依存関係をインストールします。
• update - 依存関係を更新します。
• require package/name - 新しい依存関係を追加します。
• remove package/name - 依存関係を削除します。
• require-commerce - Adobe Commerceをインストールします（該当する場合）。
• dump-autoload - オートローダーを再生成します。

使用例：

• プロジェクトの依存関係をインストールします。
• プロジェクトに新しいパッケージを追加します。
• 既存の依存関係を更新します。
• オートロードを管理します。
• Adobe Commerceコンポーネントをインストールします。

前提条件

• Warden：システムにインストールされ、構成されている必要があります。
• Docker：Wardenが機能するために必要です。
• Node.js：バージョン18.0.0以上
• MCPクライアント：互換性のあるMCPクライアント（Claude Desktop、Zedなど）

トラブルシューティング

このMCPサーバーに固有の問題については、以下を確認してください。

• npm start を実行したときのサーバーログ
• 接続問題に関するMCPクライアントログ
• Dockerコンテナのログ：warden env logs
• MCP Serverインスペクター：https://github.com/modelcontextprotocol/inspector

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

コントリビューション

コントリビューションを歓迎します！問題やプルリクエストを自由に提出してください。

関連プロジェクト

• Warden - Dockerベースの開発環境
• Model Context Protocol - プロトコル仕様
• Magento 2 - 電子商取引プラットフォーム