refactor: add completion capability and simplify capabilities config

- Updated the capabilities structure in `mcp.php` to streamline the configuration by removing nested arrays for tools, resources, prompts, and logging.
- Enhanced the `McpServiceProvider` to reflect the new configuration structure, ensuring compatibility with the updated capabilities.
- Added support for completions and clarified the experimental capabilities in the configuration.

Author: CodeWithKyrian

composer.json

@@ -21,7 +21,7 @@
     "require": {
         "php": "^8.1",
         "laravel/framework": "^9.46 || ^10.34 || ^11.29 || ^12.0",
-        "php-mcp/server": "^3.0"
+        "php-mcp/server": "^3.1"
     },
     "require-dev": {
         "laravel/pint": "^1.13",
@@ -62,4 +62,4 @@
     },
     "minimum-stability": "dev",
     "prefer-stable": true
-}
+}

config/mcp.php

@@ -153,28 +153,35 @@
     | support for tools, resources, prompts, and their related functionality like
     | subscriptions and change notifications.
     |
+    | The following capabilities are supported:
+    | - tools - Whether the server offers tools.
+    | - toolsListChanged - Whether the server supports sending a notification when the list of tools changes.
+    | - resources - Whether the server offers resources.
+    | - resourcesSubscribe - Whether the server supports resource subscriptions.
+    | - resourcesListChanged - Whether the server supports sending a notification when the list of resources changes.
+    | - prompts - Whether the server offers prompts.
+    | - promptsListChanged - Whether the server supports sending a notification when the list of prompts changes.
+    | - logging - Whether the server supports sending log messages to the client.
+    | - completions - Whether the server supports argument autocompletion suggestions.
+    | - experimental - Experimental, non-standard capabilities that the server supports.
+    |
     */
     'capabilities' => [
-        'tools' => [
-            'enabled' => (bool) env('MCP_CAP_TOOLS_ENABLED', true),
-            'listChanged' => (bool) env('MCP_CAP_TOOLS_LIST_CHANGED', true),
-        ],
+        'tools' => (bool) env('MCP_CAP_TOOLS_ENABLED', true),
+        'toolsListChanged' => (bool) env('MCP_CAP_TOOLS_LIST_CHANGED', true),
 
-        'resources' => [
-            'enabled' => (bool) env('MCP_CAP_RESOURCES_ENABLED', true),
-            'subscribe' => (bool) env('MCP_CAP_RESOURCES_SUBSCRIBE', true),
-            'listChanged' => (bool) env('MCP_CAP_RESOURCES_LIST_CHANGED', true),
-        ],
+        'resources' => (bool) env('MCP_CAP_RESOURCES_ENABLED', true),
+        'resourcesSubscribe' => (bool) env('MCP_CAP_RESOURCES_SUBSCRIBE', true),
+        'resourcesListChanged' => (bool) env('MCP_CAP_RESOURCES_LIST_CHANGED', true),
 
-        'prompts' => [
-            'enabled' => (bool) env('MCP_CAP_PROMPTS_ENABLED', true),
-            'listChanged' => (bool) env('MCP_CAP_PROMPTS_LIST_CHANGED', true),
-        ],
+        'prompts' => (bool) env('MCP_CAP_PROMPTS_ENABLED', true),
+        'promptsListChanged' => (bool) env('MCP_CAP_PROMPTS_LIST_CHANGED', true),
 
-        'logging' => [
-            'enabled' => (bool) env('MCP_CAP_LOGGING_ENABLED', true),
-            'setLevel' => (bool) env('MCP_CAP_LOGGING_SET_LEVEL', false),
-        ],
+        'logging' => (bool) env('MCP_CAP_LOGGING_ENABLED', true),
+
+        'completions' => (bool) env('MCP_CAP_COMPLETIONS_ENABLED', true),
+
+        'experimental' => null,
     ],
 
     /*

samples/basic/composer.lock

@@ -62,15 +62,16 @@ protected function buildServer(): void
             $logger = $app['log']->channel(config('mcp.logging.channel'));
             $cache = $app['cache']->store($app['config']->get('mcp.cache.store'));
             $capabilities = ServerCapabilities::make(
-                tools: config('mcp.capabilities.tools.enabled', true),
-                toolsListChanged: config('mcp.capabilities.tools.listChanged', true),
-                resources: config('mcp.capabilities.resources.enabled', true),
-                resourcesSubscribe: config('mcp.capabilities.resources.subscribe', true),
-                resourcesListChanged: config('mcp.capabilities.resources.listChanged', true),
-                prompts: config('mcp.capabilities.prompts.enabled', true),
-                promptsListChanged: config('mcp.capabilities.prompts.listChanged', true),
-                logging: config('mcp.capabilities.logging.enabled', true),
-                experimental: null,
+                tools: (bool) config('mcp.capabilities.tools', true),
+                toolsListChanged: (bool) config('mcp.capabilities.toolsListChanged', true),
+                resources: (bool) config('mcp.capabilities.resources', true),
+                resourcesSubscribe: (bool) config('mcp.capabilities.resourcesSubscribe', true),
+                resourcesListChanged: (bool) config('mcp.capabilities.resourcesListChanged', true),
+                prompts: (bool) config('mcp.capabilities.prompts', true),
+                promptsListChanged: (bool) config('mcp.capabilities.promptsListChanged', true),
+                logging: (bool) config('mcp.capabilities.logging', true),
+                completions: (bool) config('mcp.capabilities.completions', true),
+                experimental: config('mcp.capabilities.experimental', null),
             );
 
             $sessionHandler = $this->createSessionHandler($app);
@@ -83,7 +84,8 @@ protected function buildServer(): void
                 ->withCache($cache)
                 ->withSessionHandler($sessionHandler, $sessionTtl)
                 ->withCapabilities($capabilities)
-                ->withPaginationLimit((int) config('mcp.pagination_limit', 50));
+                ->withPaginationLimit((int) config('mcp.pagination_limit', 50))
+                ->withInstructions(config('mcp.server.instructions'));
 
             $registrar = $app->make(McpRegistrar::class);
             $registrar->applyBlueprints($builder);