The official PHP SDK for Model Context Protocol servers and clients. Maintained in collaboration with The PHP Foundation.

★ 1,674⑂ 204👁 24⑃ 536● 202▤ 14
PHPNOASSERTIONCreated 2025-07-15php.sdk.modelcontextprotocol.io
下载:v0.10.0v0.10.0 ↓0.10.02026-11-10
+2
日增长
1,674
stars
204
forks
24
watchers
536
prs
202
issues
14
releases

README

MCP PHP SDK






The official PHP SDK for the Model Context Protocol (MCP). It provides a framework-agnostic API for implementing MCP
servers and clients in PHP — tools, resources, prompts, STDIO and HTTP transports, sessions, authorization, and both
protocol eras (the initialize handshake and the stateless 2026-07-28 revision).

This project represents a collaboration between the PHP Foundation and the Symfony project. It adopts
development practices and standards from the Symfony project, including Coding Standards and the
Backward Compatibility Promise.

Until the first major release, this SDK is considered experimental, please see the roadmap for
planned next steps and features.

 Protocol Conformance

Measured weekly against the MCP Conformance Test Framework,
as passing checks out of total. The 2026-07-28 scores run against the framework's alpha releases, so they move as
upstream publishes new scenarios.

| Revision | Server | Client |
|:--------:|:------:|:------:|
| 2026-07-28 |  |  |
| 2025-11-25 |  |  |

 Installation

bash
composer require mcp/sdk


 Build a server

A server is a plain PHP class plus a few lines of wiring:

php
 2];
    }
}

exit(Server::builder()
    -setServerInfo('Calculator', '1.0.0')
    -setDiscovery(__DIR__, ['.'], excludeDirs: ['vendor'])
    -build()
    -run(new StdioTransport()));


The setDiscovery() call needs symfony/finder:

bash
composer require symfony/finder


The walkthrough in First server explains each piece, and
Try it with the Inspector shows it running.

 Build a client

php
use Mcp\Client\Client;
use Mcp\Client\Transport\StdioTransport;

$client = Client::builder()
    -setClientInfo('My Application', '1.0.0')
    -build();

$client-connect(new StdioTransport(command: 'php', args: ['/path/to/server.php']));

$tools = $client-listTools();
$result = $client-callTool('add', ['a' = 5, 'b' = 3]);

$client-disconnect();


See Transports for STDIO and HTTP, Connecting to a server
for timeouts, and Server-initiated requests for the handlers that
answer requests from the server.

 Documentation

The full documentation is published at php.sdk.modelcontextprotocol.io.

- Get started — Install the SDK and build your first server
- Servers — Tools, resources, resource templates, prompts, and how to register them
- Inside your handler — Talking back to the client, logging, and asking for input
- Running your server — Server builder, STDIO and HTTP transports, framework integration, sessions, authorization
- Clients — Client SDK for connecting to and communicating with MCP servers
- Protocol versions — The two protocol eras, and what revision 2026-07-28 changed
- Advanced — Events, protocol extensions (including MCP Apps), and custom message handlers
- Deprecation policy — How deprecated features are handled
- SDK tier target — Where the SDK stands on the MCP SDK tiers
- Examples — Runnable server and client examples
- API Reference — Generated class reference

 External Resources

- Model Context Protocol D

Top issues

Latest release

v0.10.0 v0.10.0 2026-11-10
What's Changed

 TL;DR

 The SDK is split into the Mcp\Schema, Mcp\Client and Mcp\Server namespaces, ahead of separate packages: most imports change
 PHP 8.2 or higher is required, and JSON-RPC batches are gone
 The client authorizes with OAuth: authorization code, client credentials, private_key_jwt and experimental cross-app access
 Handshake-era servers over HTTP run without sessions unless Builder::setSession() is called, and sessions belong to the principal that opened them
 Request handlers can run under an event loop (Revolt, ReactPHP) with the opt-in Builder::setFiberScheduler(

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON