feat(core): Integrate php-mcp/schema package for core DTOs and messages

Replaces internal MCP data structures (Requests, Responses, Results,
Content types, Enums, and model definitions like Tool, Resource)
with their counterparts from the new `php-mcp/schema` package, enhancing type safety and compliance with the MCP specification.

Author: CodeWithKyrian

composer.json

@@ -13,6 +13,7 @@
     "require": {
         "php": ">=8.1",
         "opis/json-schema": "^2.4",
+        "php-mcp/schema": "dev-main",
         "phpdocumentor/reflection-docblock": "^5.6",
         "psr/container": "^1.0 || ^2.0",
         "psr/event-dispatcher": "^1.0",
@@ -57,5 +58,11 @@
         }
     },
     "minimum-stability": "dev",
-    "prefer-stable": true
+    "prefer-stable": true,
+    "repositories": [
+        {
+            "type": "path",
+            "url": "../schema"
+        }
+    ]
 }

examples/02-discovery-http-userprofile/server.php

@@ -71,8 +71,8 @@ public function log($level, \Stringable|string $message, array $context = []): v
 
     $server->discover(__DIR__, ['.']);
 
-    // $transport = new HttpServerTransport('127.0.0.1', 8080, 'mcp');
-    $transport = new StreamableHttpServerTransport('127.0.0.1', 8080, 'mcp');
+    $transport = new HttpServerTransport('127.0.0.1', 8080, 'mcp');
+    // $transport = new StreamableHttpServerTransport('127.0.0.1', 8080, 'mcp');
 
     $server->listen($transport);
 

src/Attributes/McpResource.php

@@ -3,7 +3,7 @@
 namespace PhpMcp\Server\Attributes;
 
 use Attribute;
-use PhpMcp\Server\Model\Annotations;
+use PhpMcp\Schema\Annotations;
 
 /**
  * Marks a PHP class as representing or handling a specific MCP Resource instance.
@@ -27,6 +27,5 @@ public function __construct(
         public ?string $mimeType = null,
         public ?int $size = null,
         public ?Annotations $annotations = null,
-    ) {
-    }
+    ) {}
 }

src/Attributes/McpResourceTemplate.php

@@ -3,7 +3,7 @@
 namespace PhpMcp\Server\Attributes;
 
 use Attribute;
-use PhpMcp\Server\Model\Annotations;
+use PhpMcp\Schema\Annotations;
 
 /**
  * Marks a PHP class definition as representing an MCP Resource Template.
@@ -25,6 +25,5 @@ public function __construct(
         public ?string $description = null,
         public ?string $mimeType = null,
         public ?Annotations $annotations = null,
-    ) {
-    }
+    ) {}
 }

src/Attributes/McpTool.php

@@ -3,7 +3,7 @@
 namespace PhpMcp\Server\Attributes;
 
 use Attribute;
-use PhpMcp\Server\Model\ToolAnnotations;
+use PhpMcp\Schema\ToolAnnotations;
 
 #[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_CLASS)]
 class McpTool
@@ -17,6 +17,5 @@ public function __construct(
         public ?string $name = null,
         public ?string $description = null,
         public ?ToolAnnotations $annotations = null,
-    ) {
-    }
+    ) {}
 }

src/Configuration.php

@@ -4,7 +4,8 @@
 
 namespace PhpMcp\Server;
 
-use PhpMcp\Server\Model\Capabilities;
+use PhpMcp\Schema\Implementation;
+use PhpMcp\Schema\ServerCapabilities;
 use Psr\Container\ContainerInterface;
 use Psr\Log\LoggerInterface;
 use Psr\SimpleCache\CacheInterface;
@@ -18,9 +19,8 @@
 class Configuration
 {
     /**
-     * @param  string  $serverName  Name of this MCP server application.
-     * @param  string  $serverVersion  Version of this MCP server application.
-     * @param  Capabilities  $capabilities  Capabilities of this MCP server application.
+     * @param  Implementation  $serverInfo  Info about this MCP server application.
+     * @param  ServerCapabilities  $capabilities  Capabilities of this MCP server application.
      * @param  LoggerInterface  $logger  PSR-3 Logger instance.
      * @param  LoopInterface  $loop  ReactPHP Event Loop instance.
      * @param  CacheInterface|null  $cache  Optional PSR-16 Cache instance for registry/state.
@@ -29,15 +29,13 @@ class Configuration
      * @param  int  $paginationLimit  Maximum number of items to return for list methods.
      */
     public function __construct(
-        public readonly string $serverName,
-        public readonly string $serverVersion,
-        public readonly Capabilities $capabilities,
+        public readonly Implementation $serverInfo,
+        public readonly ServerCapabilities $capabilities,
         public readonly LoggerInterface $logger,
         public readonly LoopInterface $loop,
         public readonly ?CacheInterface $cache,
         public readonly ContainerInterface $container,
         public readonly int $definitionCacheTtl = 3600,
         public readonly int $paginationLimit = 50,
-    ) {
-    }
+    ) {}
 }

src/Contracts/ServerTransportInterface.php

@@ -6,7 +6,7 @@
 
 use Evenement\EventEmitterInterface;
 use PhpMcp\Server\Exception\TransportException;
-use PhpMcp\Server\JsonRpc\Messages\Message;
+use PhpMcp\Schema\JsonRpc\Message;
 use React\Promise\PromiseInterface;
 
 /**