modelcontextprotocol/php-sdk
Watch
1
0
Fork
You've already forked php-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Split testsuite for unit and inspector based tests (#82)

Browse source
This commit is contained in:
Christopher Hertel 2025-09-25 23:27:41 +02:00 • committed by GitHub
commit 3ec4cf612a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 188 additions and 85 deletions
Download patch file Download diff file Expand all files Collapse all files

56
tests/Unit/Schema/JsonRpc/NotificationTest.php Normal file
View file

@ -0,0 +1,56 @@
<?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\Unit\Schema\JsonRpc;
use Mcp\Schema\JsonRpc\Notification;
use PHPUnit\Framework\TestCase;
final class NotificationTest extends TestCase
{
public function testMetaIsLoopedThrough()
{
$notificationImplementation = new class extends Notification {
public static function getMethod(): string
{
return 'notifications/dummy';
}
public static function fromParams(?array $params): self
{
return new self();
}
protected function getParams(): ?array
{
return null;
}
};
$notification = $notificationImplementation::fromArray([
'jsonrpc' => '2.0',
'method' => 'notifications/dummy',
'params' => [
'_meta' => ['key' => 'value'],
],
]);
$expectedMeta = [
'jsonrpc' => '2.0',
'method' => 'notifications/dummy',
'params' => [
'_meta' => ['key' => 'value'],
],
];
$this->assertSame($expectedMeta, $notification->jsonSerialize());
}
}

58
tests/Unit/Schema/JsonRpc/RequestTest.php Normal file
View file

@ -0,0 +1,58 @@
<?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\Unit\Schema\JsonRpc;
use Mcp\Schema\JsonRpc\Request;
use PHPUnit\Framework\TestCase;
final class RequestTest extends TestCase
{
public function testMetaAndIdAreLoopedThrough()
{
$requestImplementation = new class extends Request {
public static function getMethod(): string
{
return 'foo/bar';
}
public static function fromParams(?array $params): static
{
return new self();
}
protected function getParams(): ?array
{
return null;
}
};
$notification = $requestImplementation::fromArray([
'jsonrpc' => '2.0',
'id' => '12345',
'method' => 'foo/bar',
'params' => [
'_meta' => ['key' => 'value'],
],
]);
$expectedMeta = [
'jsonrpc' => '2.0',
'id' => '12345',
'method' => 'foo/bar',
'params' => [
'_meta' => ['key' => 'value'],
],
];
$this->assertSame($expectedMeta, $notification->jsonSerialize());
}
}

406
tests/Unit/Schema/ServerCapabilitiesTest.php Normal file
View file

@ -0,0 +1,406 @@
<?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\Unit\Schema;
use Mcp\Schema\ServerCapabilities;
use PHPUnit\Framework\TestCase;
class ServerCapabilitiesTest extends TestCase
{
public function testConstructorWithDefaults(): void
{
$capabilities = new ServerCapabilities();
$this->assertTrue($capabilities->tools);
$this->assertFalse($capabilities->toolsListChanged);
$this->assertTrue($capabilities->resources);
$this->assertFalse($capabilities->resourcesSubscribe);
$this->assertFalse($capabilities->resourcesListChanged);
$this->assertTrue($capabilities->prompts);
$this->assertFalse($capabilities->promptsListChanged);
$this->assertFalse($capabilities->logging);
$this->assertFalse($capabilities->completions);
$this->assertNull($capabilities->experimental);
}
public function testConstructorWithAllParameters(): void
{
$experimental = ['feature1' => true, 'feature2' => 'enabled'];
$capabilities = new ServerCapabilities(
tools: false,
toolsListChanged: true,
resources: false,
resourcesSubscribe: true,
resourcesListChanged: true,
prompts: false,
promptsListChanged: true,
logging: true,
completions: true,
experimental: $experimental
);
$this->assertFalse($capabilities->tools);
$this->assertTrue($capabilities->toolsListChanged);
$this->assertFalse($capabilities->resources);
$this->assertTrue($capabilities->resourcesSubscribe);
$this->assertTrue($capabilities->resourcesListChanged);
$this->assertFalse($capabilities->prompts);
$this->assertTrue($capabilities->promptsListChanged);
$this->assertTrue($capabilities->logging);
$this->assertTrue($capabilities->completions);
$this->assertEquals($experimental, $capabilities->experimental);
}
public function testConstructorWithNullValues(): void
{
$capabilities = new ServerCapabilities(
tools: null,
toolsListChanged: null,
resources: null,
resourcesSubscribe: null,
resourcesListChanged: null,
prompts: null,
promptsListChanged: null,
logging: null,
completions: null,
experimental: null
);
$this->assertNull($capabilities->tools);
$this->assertNull($capabilities->toolsListChanged);
$this->assertNull($capabilities->resources);
$this->assertNull($capabilities->resourcesSubscribe);
$this->assertNull($capabilities->resourcesListChanged);
$this->assertNull($capabilities->prompts);
$this->assertNull($capabilities->promptsListChanged);
$this->assertNull($capabilities->logging);
$this->assertNull($capabilities->completions);
$this->assertNull($capabilities->experimental);
}
public function testFromArrayWithEmptyArray(): void
{
$capabilities = ServerCapabilities::fromArray([]);
$this->assertFalse($capabilities->logging);
$this->assertFalse($capabilities->completions);
$this->assertFalse($capabilities->tools);
$this->assertFalse($capabilities->prompts);
$this->assertFalse($capabilities->resources);
$this->assertNull($capabilities->toolsListChanged);
$this->assertNull($capabilities->promptsListChanged);
$this->assertNull($capabilities->resourcesSubscribe);
$this->assertNull($capabilities->resourcesListChanged);
$this->assertNull($capabilities->experimental);
}
public function testFromArrayWithBasicCapabilities(): void
{
$data = [
'tools' => new \stdClass(),
'resources' => new \stdClass(),
'prompts' => new \stdClass(),
'logging' => new \stdClass(),
'completions' => new \stdClass(),
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->tools);
$this->assertTrue($capabilities->resources);
$this->assertTrue($capabilities->prompts);
$this->assertTrue($capabilities->logging);
$this->assertTrue($capabilities->completions);
$this->assertNull($capabilities->toolsListChanged);
$this->assertNull($capabilities->promptsListChanged);
$this->assertNull($capabilities->resourcesSubscribe);
$this->assertNull($capabilities->resourcesListChanged);
}
public function testFromArrayWithPromptsArrayListChanged(): void
{
$data = [
'prompts' => ['listChanged' => true],
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->prompts);
$this->assertTrue($capabilities->promptsListChanged);
}
public function testFromArrayWithPromptsObjectListChanged(): void
{
$prompts = new \stdClass();
$prompts->listChanged = true;
$data = [
'prompts' => $prompts,
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->prompts);
$this->assertTrue($capabilities->promptsListChanged);
}
public function testFromArrayWithResourcesArraySubscribeAndListChanged(): void
{
$data = [
'resources' => [
'subscribe' => true,
'listChanged' => false,
],
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->resources);
$this->assertTrue($capabilities->resourcesSubscribe);
$this->assertFalse($capabilities->resourcesListChanged);
}
public function testFromArrayWithResourcesObjectSubscribeAndListChanged(): void
{
$resources = new \stdClass();
$resources->subscribe = false;
$resources->listChanged = true;
$data = [
'resources' => $resources,
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->resources);
$this->assertFalse($capabilities->resourcesSubscribe);
$this->assertTrue($capabilities->resourcesListChanged);
}
public function testFromArrayWithToolsArrayListChanged(): void
{
$data = [
'tools' => ['listChanged' => false],
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->tools);
$this->assertFalse($capabilities->toolsListChanged);
}
public function testFromArrayWithToolsObjectListChanged(): void
{
$tools = new \stdClass();
$tools->listChanged = true;
$data = [
'tools' => $tools,
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->tools);
$this->assertTrue($capabilities->toolsListChanged);
}
public function testFromArrayWithExperimental(): void
{
$experimental = ['feature1' => true, 'feature2' => 'test'];
$data = [
'experimental' => $experimental,
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertEquals($experimental, $capabilities->experimental);
}
public function testFromArrayWithComplexData(): void
{
$data = [
'tools' => ['listChanged' => true],
'resources' => [
'subscribe' => true,
'listChanged' => false,
],
'prompts' => ['listChanged' => true],
'logging' => new \stdClass(),
'completions' => new \stdClass(),
'experimental' => ['customFeature' => 'enabled'],
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->tools);
$this->assertTrue($capabilities->toolsListChanged);
$this->assertTrue($capabilities->resources);
$this->assertTrue($capabilities->resourcesSubscribe);
$this->assertFalse($capabilities->resourcesListChanged);
$this->assertTrue($capabilities->prompts);
$this->assertTrue($capabilities->promptsListChanged);
$this->assertTrue($capabilities->logging);
$this->assertTrue($capabilities->completions);
$this->assertEquals(['customFeature' => 'enabled'], $capabilities->experimental);
}
public function testJsonSerializeWithDefaults(): void
{
$capabilities = new ServerCapabilities();
$json = $capabilities->jsonSerialize();
$expected = [
'tools' => new \stdClass(),
'resources' => new \stdClass(),
'prompts' => new \stdClass(),
];
$this->assertEquals($expected, $json);
}
public function testJsonSerializeWithAllFeaturesEnabled(): void
{
$experimental = ['feature1' => true];
$capabilities = new ServerCapabilities(
tools: true,
toolsListChanged: true,
resources: true,
resourcesSubscribe: true,
resourcesListChanged: true,
prompts: true,
promptsListChanged: true,
logging: true,
completions: true,
experimental: $experimental
);
$json = $capabilities->jsonSerialize();
$this->assertArrayHasKey('logging', $json);
$this->assertEquals(new \stdClass(), $json['logging']);
$this->assertArrayHasKey('completions', $json);
$this->assertEquals(new \stdClass(), $json['completions']);
$this->assertArrayHasKey('prompts', $json);
$this->assertTrue($json['prompts']->listChanged);
$this->assertArrayHasKey('resources', $json);
$this->assertTrue($json['resources']->subscribe);
$this->assertTrue($json['resources']->listChanged);
$this->assertArrayHasKey('tools', $json);
$this->assertTrue($json['tools']->listChanged);
$this->assertArrayHasKey('experimental', $json);
$this->assertEquals((object) $experimental, $json['experimental']);
}
public function testJsonSerializeWithFalseValues(): void
{
$capabilities = new ServerCapabilities(
tools: false,
resources: false,
prompts: false,
logging: false,
completions: false
);
$json = $capabilities->jsonSerialize();
$this->assertEquals([], $json);
}
public function testJsonSerializeWithMixedValues(): void
{
$capabilities = new ServerCapabilities(
tools: true,
toolsListChanged: false,
resources: false,
resourcesSubscribe: true,
resourcesListChanged: true,
prompts: true,
promptsListChanged: false,
logging: false,
completions: true
);
$json = $capabilities->jsonSerialize();
$expected = [
'completions' => new \stdClass(),
'prompts' => new \stdClass(),
'resources' => (object) [
'subscribe' => true,
'listChanged' => true,
],
'tools' => new \stdClass(),
];
$this->assertEquals($expected, $json);
}
public function testJsonSerializeWithOnlyListChangedFlags(): void
{
$capabilities = new ServerCapabilities(
tools: false,
toolsListChanged: true,
resources: false,
resourcesListChanged: true,
prompts: false,
promptsListChanged: true
);
$json = $capabilities->jsonSerialize();
$expected = [
'prompts' => (object) ['listChanged' => true],
'resources' => (object) ['listChanged' => true],
'tools' => (object) ['listChanged' => true],
];
$this->assertEquals($expected, $json);
}
public function testJsonSerializeWithNullExperimental(): void
{
$capabilities = new ServerCapabilities(
tools: true,
experimental: null
);
$json = $capabilities->jsonSerialize();
$this->assertArrayNotHasKey('experimental', $json);
$this->assertArrayHasKey('tools', $json);
}
public function testFromArrayHandlesEdgeCasesGracefully(): void
{
$data = [
'prompts' => [],
'resources' => [],
'tools' => [],
];
$capabilities = ServerCapabilities::fromArray($data);
$this->assertTrue($capabilities->prompts);
$this->assertNull($capabilities->promptsListChanged);
$this->assertTrue($capabilities->resources);
$this->assertNull($capabilities->resourcesSubscribe);
$this->assertNull($capabilities->resourcesListChanged);
$this->assertTrue($capabilities->tools);
$this->assertNull($capabilities->toolsListChanged);
}
}