Phalcon

🚀 Phalcon MCP サーバ

Phalcon 5.0.x フレームワークのコマンドを実行するためのモデルコンテキストプロトコル（MCP）サーバです。このサーバは、AI アシスタントが Phalcon プロジェクト、コントローラ、モデルなどを作成および管理できるようにします。

🚀 クイックスタート

🔧 前置条件

• Phalcon Framework
• Cursor IDE
• Python 3.x
• インストール済みの Phalcon 5.0.x 開発ツール：composer global require phalcon/devtools:"^5.0.x@dev" --dev

📦 インストール

快速インストール

提供されたインストールスクリプトを使用して、すべての依存関係をインストールします。

python install.py

このスクリプトは以下をインストールします。

• 基本的な MCP サーバと依存関係
• 必須の Python パッケージ

💻 Cursor IDE での使用

1. Cursor を開き、Settings -> Cursor Settings -> MCP に移動します。
2. 「Add new MCP server」をクリックします。
3. 名前：Phalcon MCP；タイプ：Command
4. コマンド：cmd /c uv run --with mcp[cli] mcp run <完整路径>/phalcon_mcp_server.py

    "phalcon-mcp": {
      "command": "cmd",
      "args": [
        "/c",
        "uv",
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "C:\\Users\\Administrator\\Desktop\\mcp\\phalcon-mcp\\phalcon_mcp_server.py"
      ]
    }

✨ 主な機能

• phalcon_info - Phalcon のバージョンと環境情報を表示します。
• phalcon_create_project - 新しい Phalcon プロジェクトを作成します。
• phalcon_create_module - 新しいモジュールを作成します。
• phalcon_create_controller - 新しいコントローラを作成します。
• phalcon_create_model - 新しいモデルを作成します。
• phalcon_create_all_models - すべてのデータベーステーブルに対してモデルを作成します。
• phalcon_create_migration - 新しいデータベースマイグレーションを作成します。
• phalcon_create_scaffold - 完全な CRUD スキャフォールドを作成します。
• phalcon_create_webtools - Phalcon Webtools を初期化します。
• phalcon_serve - 開発サーバを起動します。
• phalcon_list_commands - すべての利用可能な Phalcon コマンドをリストします。

💻 使用例

基本的な使用法

Phalcon 情報の確認

命令：Phalcon のバージョンと環境情報を表示する
結果：現在インストールされている Phalcon のバージョンとシステム環境情報を表示します。

新しいプロジェクトの作成

命令：「my-app」という名前の新しいプロジェクトを作成する
パラメータ：
- template: basic（デフォルト）、micro または api
- directory: プロジェクトを作成する場所
結果：新しい Phalcon プロジェクトの基本構造を作成します。

モジュールの作成

命令：「admin」という名前の新しいモジュールを作成する
結果：プロジェクト内に新しいモジュールを作成します。

コントローラの作成

命令：「users」という名前の新しいコントローラを作成する
結果：プロジェクト内に新しい UsersController を作成します。

モデルの作成

命令：「User」という名前の新しいモデルを作成する
結果：プロジェクト内に新しい User モデルを作成します。

すべてのデータベーステーブルに対するモデルの作成

命令：データベースをスキャンし、すべてのテーブルに対するモデルを生成する
結果：プロジェクト内にすべてのテーブルに対応するモデルを作成します。

データベースマイグレーションの作成

命令：現在のデータベースの状態に基づいてマイグレーションファイルを生成する
結果：データベースのスキーマを同期するための新しいマイグレーションファイルを生成します。

完全な CRUD スキャフォールドの作成

命令：指定されたリソースに対して完全な CRUD 機能を生成する
結果：プロジェクト内に、作成、読み取り、更新、削除操作をサポートするコントローラとビューを作成します。

Webtools の初期化

命令：Phalcon Webtools プロジェクトを初期化する
結果：プロジェクト内に Webtools 関連の設定を構成します。

開発サーバの起動

命令：Phalcon 開発サーバを起動する
結果：アプリケーションを実行するためのローカル開発サーバを起動します。

すべての利用可能なコマンドのリスト表示

命令：すべての利用可能な Phalcon コマンドをリストする
結果：サポートされているすべての Phalcon CLI コマンドのリストを表示します。

🔧 技術詳細

この MCP サーバは、AI アシスタントが Phalcon フレームワークと対話することで開発プロセスを自動化できるようにします。プロジェクト、モジュール、コントローラ、モデルなどのプロジェクトコンポーネントを迅速に作成および管理するための一連のコマンドを提供し、データベースマイグレーションと Web アプリケーション開発をサポートします。

⚠️ 重要提示

1. Phalcon Framework が正しくインストールされていることを確認してください。
2. PHP 環境変数が正しく構成されていることを確認してください。
3. Windows システムでは、phalcon.bat がシステムパスに含まれていることを確認してください。

📄 ライセンス

MIT