d150772e24* feat: add MCP Apps extension (io.modelcontextprotocol/ui) support Adds support for the MCP Apps protocol extension, which lets servers expose interactive HTML UIs as resources rendered by spec-conforming clients (e.g. Goose) in sandboxed iframes. - Generic extension plumbing: ServerExtensionInterface and Builder::enableExtension(), with extensions advertised under capabilities.extensions during the initialize handshake. ClientCapabilities/ServerCapabilities gain an extensions field. - Schema DTOs under Mcp\Schema\Extension\Apps: the McpApps marker, UiToolMeta, ToolVisibility enum, UiResourceContentMeta, UiResourceCsp, and UiResourcePermissions (with empty-object presence markers per spec). - A worked weather example under examples/server/mcp-apps/ with a minimal spec-conforming view (ui/initialize handshake, postMessage JSONRPCMessage objects, and ResizeObserver-driven size reporting). - docs/extensions.md guide with pointers from index.md and examples.md to the ext-apps repository for the TypeScript SDK and richer view-side patterns. - Unit and inspector snapshot test coverage. Spec: https://github.com/modelcontextprotocol/ext-apps * Type UiToolMeta visibility as ToolVisibility enum Also fix UiResourceContentMeta::jsonSerialize() return phpdoc. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Address review nitpicks for MCP Apps extension Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Apply PR review feedback for MCP Apps extension Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Add regression tests and CHANGELOG entry for capabilities extensions - Pin the is_array() guards on extensions in ServerCapabilities and ClientCapabilities::fromArray() with explicit non-array payload tests. - Pin the isset()-rejects-null contract in UiResourcePermissions::fromArray(). - Surface the new extensions field on both capability classes in CHANGELOG. - Inline the ?: idiom in Builder::build() to match the surrounding style. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
51 lines
1.4 KiB
PHP
51 lines
1.4 KiB
PHP
#!/usr/bin/env php
|
|
<?php
|
|
|
|
/*
|
|
* This file is part of the official PHP MCP SDK.
|
|
*
|
|
* A collaboration between Symfony and the PHP Foundation.
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
require_once dirname(__DIR__).'/bootstrap.php';
|
|
chdir(__DIR__);
|
|
|
|
use Mcp\Example\Server\McpApps\WeatherApp;
|
|
use Mcp\Schema\Extension\Apps\McpApps;
|
|
use Mcp\Schema\Extension\Apps\ToolVisibility;
|
|
use Mcp\Schema\Extension\Apps\UiToolMeta;
|
|
use Mcp\Server;
|
|
|
|
logger()->info('Starting MCP Apps Example Server...');
|
|
|
|
$server = Server::builder()
|
|
->setServerInfo('MCP Apps Weather Example', '1.0.0')
|
|
->setLogger(logger())
|
|
->enableExtension(new McpApps())
|
|
->addResource(
|
|
[WeatherApp::class, 'getWeatherApp'],
|
|
'ui://weather-app',
|
|
'weather-app',
|
|
description: 'Interactive weather dashboard',
|
|
mimeType: McpApps::MIME_TYPE,
|
|
meta: ['ui' => McpApps::resourceMarker()],
|
|
)
|
|
->addTool(
|
|
[WeatherApp::class, 'getWeather'],
|
|
'get_weather',
|
|
description: 'Get current weather for a city',
|
|
meta: ['ui' => new UiToolMeta(
|
|
resourceUri: 'ui://weather-app',
|
|
visibility: [ToolVisibility::Model, ToolVisibility::App],
|
|
)],
|
|
)
|
|
->build();
|
|
|
|
$result = $server->run(transport());
|
|
|
|
logger()->info('Server stopped gracefully.', ['result' => $result]);
|
|
|
|
shutdown($result);
|