Integrations

Provides tools for working with Phalcon PHP Framework 5.0.x, enabling the creation and management of Phalcon projects, controllers, models, modules, migrations, and CRUD scaffolding.

Phalcon MCP Server

一个用于执行 Phalcon 5.0.x 框架命令的 Model Context Protocol (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 中使用

打开 Cursor，导航到 Settings->Cursor Settings->MCP
点击：Add new MCP server
名称：Phalcon MCP；类型：Command
命令：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" 的控制器
参数：
- base_class: 可选的基类
结果：创建一个新的控制器文件

创建模型

命令：创建一个名为 "Products" 的模型
参数：
- schema: 数据库 schema
- namespace: 命名空间
结果：创建一个新的模型文件

创建所有模型

命令：为数据库中的所有表创建模型
参数：
- schema: 数据库 schema
- namespace: 命名空间
结果：为所有数据库表创建对应的模型文件

创建迁移

命令：创建一个名为 "create_users_table" 的迁移
参数：
- table_name: 表名
- directory: 迁移文件位置
结果：创建一个新的数据库迁移文件

创建脚手架

命令：为 "products" 创建完整的 CRUD 界面
参数：
- schema: 数据库 schema
- template: 模板引擎
- force: 是否强制创建
结果：生成完整的 CRUD 接口

初始化 Webtools

命令：在项目中初始化 Phalcon Webtools
结果：设置 Phalcon 的 Web 开发工具

启动开发服务器

命令：启动开发服务器
参数：
- host: 主机地址（默认：localhost）
- port: 端口号（默认：8000）
结果：启动 PHP 开发服务器运行应用

工作原理

该服务器使用 MCP 协议与 Cursor IDE 集成，允许 AI 助手直接执行 Phalcon 命令行工具的各种功能。它通过标准输入输出（stdin/stdout）进行通信，不需要额外的网络端口。

注意事项

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

许可证

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

A Model Context Protocol server that allows AI assistants to create and manage Phalcon 5.0.x framework projects by executing Phalcon commands directly from Cursor IDE.