이 패키지는 모델 컨텍스트 프로토콜(Model Context Protocol)을 위한 PHP SDK를 제공합니다. 이 프로젝트의 주요 목표는 순수 PHP를 사용하여 MCP 서버와 MCP 클라이언트를 모두 제공하여 일반적인 서버 구성의 PHP/Apache/cPanel 호스팅 환경에서 쉽게 사용할 수 있도록 하는 것입니다.

개요

이 PHP SDK는 전체 MCP 사양을 구현하여 다음을 쉽게 할 수 있게 합니다:

• 모든 MCP 서버에 연결할 수 있는 MCP 클라이언트를 구축합니다
• 리소스, 프롬프트 및 도구를 노출하는 MCP 서버 생성
• stdio, HTTP 같은 표준 전송 사용
• 2024-11-05부터 2026-07-28까지의 모든 사양 개정판에서 피어와 상호 운용할 수 있음 — 버전 협상이 내장되어 있습니다

이 SDK는 MCP 및 PHP 개발자 커뮤니티에 두 가지 주요 이점을 제공합니다:

• 이 SDK는 해당 필수 MCP 적합성 테스트에서 100% 합격률을 특징으로 하며, 안정 트랙 기준선은 비어 있으며, 추가로 2026-07-28 사양 업데이트를 검증하는 초안 트랙 스위트를 실행합니다. 적합성 테스트를 참조하세요.

• SDK는 단일 Composer 명령어로 기능적인 MCP 클라이언트와 MCP 서버를 모두 시연할 수 있습니다. 웹 클라이언트 예제를 참조하세요.

v2 신규

v2는 두 가지 주요 특징을 중심으로 구축되었습니다 — MCP 첫날 지원

Model Context Protocol SDK for PHP

This package provides a PHP SDK for the Model Context Protocol. The primary goal of this project is to provide both an MCP server and an MCP client using pure PHP, making it easy to use in PHP/Apache/cPanel hosting environments with typical server configurations.

Overview

This PHP SDK implements the full MCP specification, making it easy to:

• Build MCP clients that can connect to any MCP server
• Create MCP servers that expose resources, prompts and tools
• Use standard transports like stdio and HTTP
• Interoperate with peers on any spec revision from 2024-11-05 through 2026-07-28 — version negotiation is built in

This SDK offers two major advantages for the MCP and PHP developer communities:

• This SDK features a 100% pass rate on the applicable required MCP Conformance Tests — the stable-track baseline is empty — and additionally runs the draft-track suite validating the 2026-07-28 spec update. See Conformance Testing.

• The SDK can demonstrate both a functional MCP client and MCP server with a single Composer command. See the Webclient Example.

New in v2

v2 is built around two headline features — day-one support for the MCP 2026-07-28 “stateless core” spec revision, and full support for the MCP Apps extension — delivered without giving up compatibility with any earlier revision:

• 2026-07-28 stateless core — no initialize handshake, no session ids: every request is self-contained, which is exactly the model that fits typical PHP web hosting (a fresh process per request). Includes server/discover, caching hints, request-metadata headers, subscriptions/listen streams, and multi-round-trip input gathering.
• Dual-era negotiation — servers detect each request’s era and clients probe-then-fall-back automatically, so one codebase serves both modern (2026-07-28) and legacy (2024-11-05 … 2025-11-25) peers concurrently.
• Tasks extension (SEP-2663) — long-running tool calls return a task handle that clients poll, cancel, and feed input to; backed by a file-based store that works on shared hosting. See the Tasks guide.
• MCP Apps extension (SEP-1865) — attach a host-rendered HTML UI to a tool with one ->ui(...) call. See the Apps guide.

The complete inventory — including OAuth 2.1 hardening, typed errors, and the feature-lifecycle deprecation registry — is in the CHANGELOG; API differences from v1 are covered in the