logiscape/mcp-sdk-php

解决的问题

本项目提供了 Model Context Protocol (MCP) 的 PHP 实现，允许 PHP 开发者将其应用程序与 AI 模型集成。它专门解决了在典型 PHP 网页托管环境（如 Apache 或 cPanel）中运行 MCP 服务器和客户端的挑战，在这些环境中，进程通常是短暂且无状态的。

工作原理

该 SDK 实现了完整的 MCP 规范，同时支持客户端和服务器角色。它使用如 stdio 和 HTTP 等标准传输方式进行通信。其关键特性是支持“无状态核心”（规范修订版 2026-07-28），这消除了对初始化握手和 session ID 的需求，使其非常适合网页托管的请求-响应循环。

适用人群

希望构建可由基于 LLM 的客户端访问的 AI 驱动工具、资源和提示词的 PHP 开发者，或者希望构建作为 MCP 客户端以连接其他 MCP 服务器的 PHP 应用程序的开发者。

亮点

• 无状态核心支持：通过消除每个请求的 session ID 和握手，针对 PHP 网页托管进行了优化。
• 双世代协商：自动处理现代 (2026-07-28) 与旧版 (2024-11-05) MCP 规范之间的兼容性。
• MCP Apps 扩展：允许开发者通过单一方法调用，将主机端渲染的 HTML UI 附加到工具上。
• Tasks 扩展：通过基于文件的存储支持长时间运行的工具调用，在共享托管环境中实现轮询和取消功能。
• 一致性测试：在官方 MCP 一致性测试中保持高通过率。
• CURL 和 JSON 支持：为 PHP 8.1+ 打造，仅需最少的外部依赖项。