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 許可證。