Php MCP Protocol Server

🚀 PHP MCP 协议服务器

PHP MCP（模型上下文协议）服务器用于将 PHP 集成到 Anthropic 的 Claude AI 中。它基于官方 SDK MCP 实现，为用户提供了一个兼容且可靠的解决方案。

🚀 快速开始

系统要求

• 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 应用中，配置使用本地工具 MCP，选择地址 localhost:7654。
3. 现在可以直接在 Claude 中执行 PHP 代码！

✨ 主要特性

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

💻 使用示例

基础用法

在 Claude 中使用 PHP 的示例：

你能帮我执行以下 PHP 代码吗？

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

echo "JSON 数据：\n";
echo json_encode($data, JSON_PRETTY_PRINT);
?>

📚 详细文档

API MCP 接口

该服务器提供了两种 MCP 工具：

executePhp

执行给定的 PHP 代码并返回输出结果。 参数：

• code (字符串)：待执行的 PHP 代码

返回值：

• output (字符串)：代码执行后的输出
• error (字符串，可选)：错误信息（如有）
• exitCode (数字，可选)：PHP 进程的退出状态码

phpInfo

返回有关 PHP 环境的详细信息。 参数： 无

返回值：

• info (字符串)：包含版本、扩展和配置的 PHP 环境信息

🔧 技术细节

若服务器无法启动或出现错误，请按以下步骤操作：

1. 确认 PHP 是否安装并正确添加到系统 PATH。
2. 确认 7654 端口（或其他指定端口）可用。
3. 查看服务器日志以获取详细错误信息。

📄 许可证

本项目采用 MIT 许可证。