MCP Phpstan Server

🚀 MCP PHPStan 服务器（本地运行，无需依赖）

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

• phpstan_analyze：运行 PHPStan 并返回可读的报告。
• phpstan_pro：运行 PHPStan Pro 以获取 JSON 输出（如果可用），用于更丰富的诊断。

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

✨ 主要特性

• 轻量级实现：纯 PHP 编写，无需 Composer 依赖，易于集成到各类项目。
• 双工具支持：提供 phpstan_analyze 和 phpstan_pro 两个工具，满足不同的代码分析需求。
• 灵活配置：支持通过环境变量或配置文件进行灵活配置。

📦 安装指南

此项目无需复杂的安装步骤，只需将其复制到目标项目中即可。

🚀 快速开始

配置

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

• MCP_PHPSTAN_PATH：phpstan 二进制文件的路径（默认值：先查找 vendor/bin/phpstan，若未找到则在系统路径中查找 phpstan）。
• MCP_PHPSTAN_CONFIG：phpstan.neon 或 phpstan.neon.dist 文件的路径（可选；会自动向上级目录查找）。
• MCP_PHPSTAN_LEVEL：传递给 phpstan 的级别（例如 max 或 8），若配置文件中未设置则使用此值。

如果未提供配置，服务器会从当前工作目录向上查找以下文件之一：phpstan.neon、phpstan.neon.dist。

运行

首先，将脚本设置为可执行：

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

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

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

示例：Claude Desktop 配置

{
  "mcpServers": {
    "phpstan": {
      "command": "/absolute/path/to/mcp/phpstan-server/bin/mcp-phpstan",
      "env": {
        "MCP_PHPSTAN_PATH": "/usr/local/bin/phpstan",
        "MCP_PHPSTAN_CONFIG": "/path/to/your/phpstan.neon",
        "MCP_PHPSTAN_LEVEL": "max"
      }
    }
  }
}

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

• initialize
• tools/list
• tools/call

💻 使用示例

基础用法

phpstan_analyze

输入模式：

{
  "type": "object",
  "properties": {
    "paths": {"type": "array", "items": {"type": "string"}},
    "level": {"type": ["string", "integer"], "description": "Override level"}
  },
  "required": ["paths"]
}

phpstan_pro

输入模式与 phpstan_analyze 相同，但在可能的情况下直接返回 JSON 数据。

🔧 技术细节

项目结构（DDD）

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

注意事项

• 标准输出（STDOUT）仅输出 JSON-RPC 消息，日志信息会输出到标准错误（STDERR）。
• phpstan 的非零退出码可能表示有代码问题，也可能表示执行失败；我们会解析输出以确定错误状态。