MCP Phpcs Server

🚀 MCP PHPCS服务器（本地，无依赖）

这是一个用纯PHP实现的最小化模型上下文协议（MCP）服务器，它提供了两个工具：

• phpcs_check：运行PHP_CodeSniffer并返回可读报告。
• phpcbf_fix：运行PHP代码美化和修复工具。

该服务器无需Composer依赖，可直接复制到任何项目中使用。

🚀 快速开始

运行前准备

将脚本设置为可执行文件：

chmod +x mcp/phpcs-server/bin/mcp-phpcs

启动服务器

配置你的MCP客户端，通过标准输入输出（stdio）使用以下命令启动服务器：

/absolute/path/to/mcp/phpcs-server/bin/mcp-phpcs

示例：Claude桌面端配置

在你的MCP配置文件中添加以下内容：

{
  "mcpServers": {
    "phpcs": {
      "command": "/absolute/path/to/mcp/phpcs-server/bin/mcp-phpcs",
      "env": {
        "MCP_PHPCS_PATH": "/usr/local/bin/phpcs",
        "MCP_PHPCBF_PATH": "/usr/local/bin/phpcbf",
        "MCP_PHPCS_RULESET": "/path/to/your/phpcs.xml"
      }
    }
  }
}

该服务器通过标准输入输出（STDIN/STDOUT）使用JSON-RPC 2.0协议，并实现了以下方法：

• initialize
• tools/list
• tools/call

✨ 主要特性

• 轻量级：纯PHP实现，无需Composer依赖。
• 可移植：可直接复制到任何项目中使用。
• 功能丰富：提供phpcs_check和phpcbf_fix两个实用工具。

📦 安装指南

该项目无需安装额外依赖，只需将代码复制到项目中即可。

📚 详细文档

项目结构（DDD）

• src/Domain：工具契约和结果
• src/Application：JSON-RPC MCP服务器和注册表
• src/Infrastructure：进程运行器、配置、规则集发现、工具实现
• bin/mcp-phpcs：标准输入输出入口点

配置

你可以通过环境变量或config/config.json文件进行配置：

• MCP_PHPCS_PATH – phpcs二进制文件的路径（默认：PATH中的phpcs）
• MCP_PHPCBF_PATH – phpcbf二进制文件的路径（默认：PATH中的phpcbf）
• MCP_PHPCS_RULESET – 规则集的路径（例如：phpcs.xml）

如果未提供规则集，服务器将从当前工作目录向上搜索以下文件之一： phpcs.xml、phpcs.xml.dist、ruleset.xml。

💻 使用示例

phpcs_check

输入模式：

{
  "type": "object",
  "properties": {
    "path": {"type": "string"}
  },
  "required": ["path"]
}

phpcbf_fix

输入模式与phpcs_check相同。

🔧 技术细节

• 输出到标准输出（STDOUT）的严格为JSON-RPC消息，日志输出到标准错误（STDERR）。
• phpcs的非零退出代码被视为违规（不一定是致命错误）。