PHP MCP Protocol Server

PHP MCP 协议服务

PHP 的 MCP（Model Context Protocol）服务，可将 PHP 与 Anthropic 的 Claude AI 集成。它使用官方 MCP SDK，提供稳健且符合协议规范的解决方案。

功能

• 直接通过 Claude 执行 PHP 代码
• 基于 Anthropic 官方 MCP SDK 实现
• 妥善处理错误和异常
• 自动清理临时文件
• 支持检查 PHP 环境

要求

• Node.js（v14 或更高版本）
• PHP（v7.0 或更高版本）
• npm 或 yarn

安装

全局安装（推荐）

npm install -g php-mcp-protocol-server

全局安装后，可以通过以下命令启动服务：

php-mcp-server

通过 npm 本地安装

npm install php-mcp-protocol-server

通过 GitHub 安装

git clone https://github.com/Lucasdoreac/php-mcp-protocol-server.git
cd php-mcp-protocol-server
npm install

使用

检查 PHP 环境

开始之前，请确认 PHP 已正确安装：

npm run verify

启动服务

npm start

默认情况下，服务会监听 7654 端口。可以通过设置环境变量 MCP_PORT 来更改端口。

与 Claude AI 集成

1. 启动 PHP MCP 服务
2. 在 Claude Desktop 应用中，将其配置为使用 localhost:7654 上的本地 MCP 工具
3. 现在即可直接通过 Claude 执行 PHP 代码！

MCP API

该服务提供两个 MCP 工具：

executePhp

执行 PHP 代码并返回输出。

参数：

• code（string）：要执行的 PHP 代码

返回值：

• output（string）：PHP 代码的输出
• error（string，可选）：错误消息（如果有）
• exitCode（number，可选）：PHP 进程的退出代码

phpInfo

返回 PHP 环境的详细信息。

参数： 无

返回值：

• info（string）：PHP 环境信息，包括版本、扩展和配置

在 Claude 中使用示例

要在 Claude 中使用 PHP，只需让它执行 PHP 代码。例如：

Pode executar este código PHP para mim?

<?php
$data = [
  'nome' => 'Exemplo',
  'valor' => 42,
  'timestamp' => time()
];

echo "Dados em JSON:\n";
echo json_encode($data, JSON_PRETTY_PRINT);
?>

故障排除

如果服务无法启动或发生错误：

1. 检查是否已安装 PHP，且 PHP 位于系统 PATH 中
2. 确认 7654 端口（或配置的端口）可用
3. 查看服务日志中的详细错误信息

许可证

MIT