Phalcon

🚀 Phalcon MCP 服务器

Phalcon MCP 服务器是一个用于执行 Phalcon 5.0.x 框架命令的模型上下文协议（MCP）服务器。它允许 AI 助手创建和管理 Phalcon 项目、控制器、模型等，极大地提升了开发效率。

🚀 快速开始

Phalcon MCP 服务器允许 AI 助手与 Phalcon 框架交互，自动化开发流程。通过一系列命令，可快速创建和管理项目组件，并支持数据库迁移和 Web 应用开发。

📦 安装指南

前置条件

• 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 包

💻 使用示例

基础用法

查看 Phalcon 信息

命令：查看 Phalcon 版本和环境信息
结果：显示当前安装的 Phalcon 版本和系统环境信息

创建新项目

命令：创建一个名为 "my-app" 的新项目
参数：
- template: basic（默认）、micro 或 api
- directory: 项目创建位置
结果：创建一个新的 Phalcon 项目基础结构

创建模块

命令：创建一个名为 "admin" 的新模块
结果：在项目中创建一个新的模块

创建控制器

命令：创建一个名为 "users" 的新控制器
结果：在项目中创建一个新的 UsersController

创建模型

命令：创建一个名为 "User" 的新模型
结果：在项目中创建一个新的 User 模型

为所有数据库表创建模型

命令：扫描数据库并为所有表生成模型
结果：在项目中创建所有表对应的模型

创建数据库迁移

命令：基于当前数据库状态生成迁移文件
结果：生成新的迁移文件以同步数据库 schema

创建完整的 CRUD 脚手架

命令：为指定资源生成完整的 CRUD 功能
结果：在项目中创建控制器和视图以支持增删改查操作

初始化 Webtools

命令：初始化 Phalcon Webtools 项目
结果：在项目中配置 Webtools 相关设置

启动开发服务器

命令：启动 Phalcon 开发服务器
结果：启动本地开发服务器以运行应用

列出所有可用命令

命令：列出所有可用的 Phalcon 命令
结果：显示所有支持的 Phalcon CLI 命令列表

📚 详细文档

在 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 命令

🔧 技术细节

该 MCP 服务器允许 AI 助手通过与 Phalcon 框架交互来自动化开发流程。它提供了一系列命令，用于快速创建和管理项目组件，如项目、模块、控制器、模型等，并支持数据库迁移和 Web 应用开发。

⚠️ 注意事项

⚠️ 重要提示

1. 确保已正确安装 Phalcon Framework
2. 确保 PHP 环境变量配置正确
3. Windows 系统需要确保 phalcon.bat 在系统路径中

📄 许可证

本项目采用 MIT 许可证。