项目简介
PHPocalypse MCP 是一个为 PHP 开发者设计的 Model Context Protocol (MCP) 服务器。它允许你将 PHP 项目中常用的开发工具集成到支持 MCP 协议的 LLM 客户端(如 Cursor)中,从而在 LLM 环境中直接执行代码格式化、静态分析、单元测试和行为驱动测试等任务。
主要功能点
- 工具执行: 允许你在 YAML 配置文件中定义和注册各种 PHP 相关的命令行工具,例如代码风格检查器、静态分析器和测试运行器。
- 命令配置: 通过简单的 YAML 格式配置文件,你可以轻松地配置每个工具的执行命令,包括命令路径、参数等。
- 标准输出: 工具执行结果以标准 JSON 格式返回给 LLM 客户端,方便 LLM 理解和处理。
- Stdio 传输: 使用标准的 Stdio (标准输入输出) 作为 MCP 服务器与客户端之间的通信协议,易于部署和集成。
安装步骤
- 克隆仓库: 首先,使用 Git 克隆 PHPocalypse-MCP 仓库到你本地的目录:
git clone https://github.com/plapinski/PHPocalypse-MCP - 安装依赖: 进入克隆下来的仓库目录,并安装项目依赖:
cd PHPocalypse-MCP npm install - 创建配置文件: 在你的 PHP 项目根目录下,创建一个名为 'phpocalypse-mcp.yaml' 的配置文件。
服务器配置
在你的 MCP 客户端(例如 Cursor)的设置中,添加以下 MCP 服务器配置。请根据你的实际路径修改 'command' 和 'args' 中的路径。
{ "mcpServers": { "phpocalypse-mcp": { "command": "npx", "args": ["tsx", "/Absolute/Path/To/PHPocalypse-MCP/src/index.ts", "--config", "/Absolute/Path/To/Your/PHP/Based/Project/phpocalypse-mcp.yaml"] } } }
配置参数说明:
- 'server name': 'phpocalypse-mcp' (服务器名称,在客户端中用于标识)
- 'command': 'npx' (启动服务器的命令,这里使用 'npx' 运行 'tsx')
- 'args': 启动参数,包括:
- 'tsx': 用于执行 TypeScript 代码的工具
- '/Absolute/Path/To/PHPocalypse-MCP/src/index.ts': PHPocalypse MCP 服务器入口文件 (请替换为 PHPocalypse-MCP 仓库在你的电脑上的绝对路径)
- '--config': 指定配置文件路径的参数
- '/Absolute/Path/To/Your/PHP/Based/Project/phpocalypse-mcp.yaml': 你的 PHP 项目中 'phpocalypse-mcp.yaml' 配置文件的绝对路径 (请替换为你的 PHP 项目配置文件在你的电脑上的绝对路径)
基本使用方法
- 确保你的 MCP 客户端已正确配置并连接到 PHPocalypse MCP 服务器。
- 在你的 'phpocalypse-mcp.yaml' 文件中定义你需要的 PHP 工具,例如代码格式化、静态分析或测试命令。
- 在 MCP 客户端中,你可以通过工具名称调用已配置的工具。服务器将执行相应的命令,并将结果返回给客户端。
例如,如果你的 'phpocalypse-mcp.yaml' 中配置了名为 'php-cs-fixer' 的工具,你可以在支持工具调用的 LLM 客户端中指示它调用 'php-cs-fixer' 工具来格式化你的 PHP 代码。
信息
分类
开发者工具