fc456125e2* Add resource_link content block The spec's `resource_link` content type (protocol revision 2025-06-18, still present in 2025-11-25) had no corresponding schema class: it lets a tool result or prompt message reference a resource by URI/name without embedding its full contents, the way `EmbeddedResource` does. Without it, tools returning many or large resource references (e.g. search results over a DAM) are stuck smuggling URIs through text/structured content. Add `Mcp\Schema\Content\ResourceLink`, mirroring the spec's `Resource` shape (uri, name, title, description, mimeType, annotations, size, icons, _meta) with a fixed `type: "resource_link"`, following the conventions of the sibling `EmbeddedResource`/`ResourceDefinition` classes. Register it everywhere `resource` content blocks are (de)serialized by type per the spec's `ContentBlock` union: - `CallToolResult::fromArray()` - `PromptMessage` (constructor type, `fromArray()`, phpstan types) - `PromptResultFormatter` (typed-array and direct-instance paths) `SamplingMessage`/`CreateSamplingMessageResult` are intentionally left unchanged: the spec's `SamplingMessageContentBlock` does not include `ResourceLink`. Fixes #399 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * Add resource_link example coverage to discovery-userprofile Add a lookup_user tool to the discovery-userprofile example: given a userId, it returns a short text summary plus a resource_link pointing at the existing user://{userId}/profile resource template, instead of embedding the profile. This mirrors the PR's motivating use case (a tool referencing many/large resources by URI rather than inlining them) and exercises resource_link through the example's own inspector snapshot tests (tools_call-lookup_user[_not_found], tools_list). Wiring this up surfaced a real bug: ToolReference::extractStructuredContent() passed any raw array return value straight through as structuredContent, even when it held Content instances (e.g. the TextContent/ResourceLink pair above). That serializes to a JSON list, which fails the spec's requirement that structuredContent be an object - the inspector's MCP client rejected the tool call outright until fixed. Skip structuredContent extraction whenever the raw result contains a Content item, since those are already represented in `content` and were never meant to double as structured data. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Alex Rothberg <51059+cancan101@users.noreply.github.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
88 lines
3 KiB
PHP
88 lines
3 KiB
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.
|
|
*/
|
|
|
|
namespace Mcp\Tests\Inspector\Http;
|
|
|
|
final class HttpDiscoveryUserProfileTest extends HttpInspectorSnapshotTestCase
|
|
{
|
|
public static function provideMethods(): array
|
|
{
|
|
return [
|
|
...parent::provideMethods(),
|
|
'Lookup User Tool' => [
|
|
'method' => 'tools/call',
|
|
'options' => [
|
|
'toolName' => 'lookup_user',
|
|
'toolArgs' => ['userId' => '"101"'],
|
|
],
|
|
'testName' => 'lookup_user',
|
|
],
|
|
'Lookup User Tool (Not Found)' => [
|
|
'method' => 'tools/call',
|
|
'options' => [
|
|
'toolName' => 'lookup_user',
|
|
'toolArgs' => ['userId' => '"999"'],
|
|
],
|
|
'testName' => 'lookup_user_not_found',
|
|
],
|
|
'Send Welcome Tool' => [
|
|
'method' => 'tools/call',
|
|
'options' => [
|
|
'toolName' => 'send_welcome',
|
|
'toolArgs' => ['userId' => '"101"', 'customMessage' => 'Welcome to our platform!'],
|
|
],
|
|
'testName' => 'send_welcome',
|
|
],
|
|
'Test Tool Without Params' => [
|
|
'method' => 'tools/call',
|
|
'options' => [
|
|
'toolName' => 'test_tool_without_params',
|
|
'toolArgs' => [],
|
|
],
|
|
'testName' => 'test_tool_without_params',
|
|
],
|
|
'Read User Profile 101' => [
|
|
'method' => 'resources/read',
|
|
'options' => [
|
|
'uri' => 'user://101/profile',
|
|
],
|
|
'testName' => 'read_user_profile_101',
|
|
],
|
|
'Read User Profile 102' => [
|
|
'method' => 'resources/read',
|
|
'options' => [
|
|
'uri' => 'user://102/profile',
|
|
],
|
|
'testName' => 'read_user_profile_102',
|
|
],
|
|
'Read User ID List' => [
|
|
'method' => 'resources/read',
|
|
'options' => [
|
|
'uri' => 'user://list/ids',
|
|
],
|
|
'testName' => 'read_user_id_list',
|
|
],
|
|
'Generate Bio Prompt (Formal)' => [
|
|
'method' => 'prompts/get',
|
|
'options' => [
|
|
'promptName' => 'generate_bio_prompt',
|
|
'promptArgs' => ['userId' => '101', 'tone' => 'formal'],
|
|
],
|
|
'testName' => 'generate_bio_prompt',
|
|
],
|
|
];
|
|
}
|
|
|
|
protected function getServerScript(): string
|
|
{
|
|
return \dirname(__DIR__, 3).'/examples/server/discovery-userprofile/server.php';
|
|
}
|
|
}
|