Enabled logging by default

Author: Adebayo120

README.md

@@ -229,31 +229,6 @@ $server = Server::builder()
     ->build();
 ```
 
-### Logging
-
-Automatically inject PSR-3 compatible logger into your registered handlers:
-
-```php
-// Enable logging in server
-$server = Server::builder()
-    ->enableClientLogging()
-    ->build();
-
-// Use in any handler - logger is auto-injected
-#[McpTool]
-public function processData(string $input, ClientLogger $logger): array {
-    $logger->info('Processing data', ['input' => $input]);
-    return ['result' => 'processed'];
-}
-
-// Also works with PSR-3 LoggerInterface
-#[McpResource(uri: 'data://config')]
-public function getConfig(LoggerInterface $logger): array {
-    $logger->info('Config accessed');
-    return ['setting' => 'value'];
-}
-```
-
 ## Documentation
 
 **Core Concepts:**

docs/mcp-elements.md

@@ -11,6 +11,7 @@ discovery and manual registration methods.
 - [Resources](#resources)
 - [Resource Templates](#resource-templates)
 - [Prompts](#prompts)
+- [Logging](#logging)
 - [Completion Providers](#completion-providers)
 - [Schema Generation and Validation](#schema-generation-and-validation)
 - [Discovery vs Manual Registration](#discovery-vs-manual-registration)
@@ -478,6 +479,55 @@ public function generatePrompt(string $topic, string $style): array
 
 The SDK automatically validates that all messages have valid roles and converts the result into the appropriate MCP prompt message format.
 
+## Logging
+
+The SDK provides automatic logging support, handlers can receive logger instances automatically to send structured log messages to clients.
+
+### Configuration
+
+Logging is **enabled by default**. Use `disableClientLogging()` to turn it off:
+
+```php
+// Logging enabled (default)
+$server = Server::builder()->build();
+
+// Disable logging
+$server = Server::builder()
+    ->disableClientLogging()
+    ->build();
+```
+
+### Auto-injection
+
+The SDK automatically injects logger instances into handlers:
+
+```php
+use Mcp\Capability\Logger\ClientLogger;
+use Psr\Log\LoggerInterface;
+
+#[McpTool]
+public function processData(string $input, ClientLogger $logger): array {
+    $logger->info('Processing started', ['input' => $input]);
+    $logger->warning('Deprecated API used');
+    
+    // ... processing logic ...
+    
+    $logger->info('Processing completed');
+    return ['result' => 'processed'];
+}
+
+// Also works with PSR-3 LoggerInterface
+#[McpResource(uri: 'data://config')]
+public function getConfig(LoggerInterface $logger): array {
+    $logger->info('Configuration accessed');
+    return ['setting' => 'value'];
+}
+```
+
+### Log Levels
+
+The SDK supports all standard PSR-3 log levels with **warning** as the default level:
+
 ## Completion Providers
 
 Completion providers help MCP clients offer auto-completion suggestions for Resource Templates and Prompts. Unlike Tools

docs/server-builder.md

@@ -508,6 +508,7 @@ $server = Server::builder()
 | `addRequestHandlers()` | handlers | Prepend multiple custom request handlers |
 | `addNotificationHandler()` | handler | Prepend a single custom notification handler |
 | `addNotificationHandlers()` | handlers | Prepend multiple custom notification handlers |
+| `disableClientLogging()` | - | Disable MCP client logging (enabled by default) |
 | `addTool()` | handler, name?, description?, annotations?, inputSchema? | Register tool |
 | `addResource()` | handler, uri, name?, description?, mimeType?, size?, annotations? | Register resource |
 | `addResourceTemplate()` | handler, uriTemplate, name?, description?, mimeType?, annotations? | Register resource template |

examples/stdio-discovery-calculator/McpElements.php

@@ -32,8 +32,7 @@ final class McpElements
 
     public function __construct(
         private readonly LoggerInterface $logger = new NullLogger(),
-    ) {
-    }
+    ) {}
 
     /**
      * Performs a calculation based on the operation.
@@ -95,7 +94,7 @@ public function calculate(float $a, float $b, string $operation, ClientLogger $l
         }
 
         $finalResult = round($result, $this->config['precision']);
-        $logger->info('✅ Calculation completed successfully', [
+        $logger->info('Calculation completed successfully', [
             'result' => $finalResult,
             'precision' => $this->config['precision'],
         ]);
@@ -164,7 +163,7 @@ public function updateSetting(string $setting, mixed $value, ClientLogger $logge
                 return ['success' => false, 'error' => 'Invalid precision value. Must be integer between 0 and 10.'];
             }
             $this->config['precision'] = $value;
-            $logger->info('✅ Precision setting updated', [
+            $logger->info('Precision setting updated', [
                 'new_precision' => $value,
                 'previous_config' => $this->config,
             ]);
@@ -190,12 +189,12 @@ public function updateSetting(string $setting, mixed $value, ClientLogger $logge
             }
         }
         $this->config['allow_negative'] = $value;
-        $logger->info('✅ Allow negative setting updated', [
+        $logger->info('Allow negative setting updated', [
             'new_allow_negative' => $value,
             'updated_config' => $this->config,
         ]);
 
         // $registry->notifyResourceChanged('config://calculator/settings');
-        return ['success' => true, 'message' => 'Allow negative results set to '.($value ? 'true' : 'false').'.'];
+        return ['success' => true, 'message' => 'Allow negative results set to ' . ($value ? 'true' : 'false') . '.'];
     }
 }

examples/stdio-discovery-calculator/server.php

@@ -10,7 +10,7 @@
  * file that was distributed with this source code.
  */
 
-require_once dirname(__DIR__).'/bootstrap.php';
+require_once dirname(__DIR__) . '/bootstrap.php';
 chdir(__DIR__);
 
 use Mcp\Server;
@@ -23,7 +23,6 @@
     ->setInstructions('This server supports basic arithmetic operations: add, subtract, multiply, and divide. Send JSON-RPC requests to perform calculations.')
     ->setContainer(container())
     ->setLogger(logger())
-    ->enableClientLogging()  // Enable Client logging capability and auto-injection!
     ->setDiscovery(__DIR__, ['.'])
     ->build();
 

examples/stdio-logging-showcase/server.php

@@ -10,7 +10,7 @@
  * file that was distributed with this source code.
  */
 
-require_once dirname(__DIR__).'/bootstrap.php';
+require_once dirname(__DIR__) . '/bootstrap.php';
 chdir(__DIR__);
 
 use Mcp\Server;
@@ -23,7 +23,6 @@
     ->setServerInfo('Stdio Logging Showcase', '1.0.0', 'Demonstration of auto-injected MCP logging in capability handlers.')
     ->setContainer(container())
     ->setLogger(logger())
-    ->enableClientLogging()  // Enable MCP logging capability and auto-injection!
     ->setDiscovery(__DIR__, ['.'])
     ->build();
 

src/Capability/Discovery/SchemaGenerator.php

@@ -806,7 +806,7 @@ private function isAutoInjectedParameter(\ReflectionParameter $parameter): bool
         $typeName = $type->getName();
 
         // Auto-inject for ClientLogger or LoggerInterface types
-        return 'Mcp\\Capability\\Logger\\ClientLogger' === $typeName 
+        return 'Mcp\\Capability\\Logger\\ClientLogger' === $typeName
             || 'Psr\\Log\\LoggerInterface' === $typeName;
     }
 }

src/Capability/Registry.php

@@ -66,9 +66,9 @@ final class Registry implements ReferenceProviderInterface, ReferenceRegistryInt
 
     private ServerCapabilities $serverCapabilities;
 
-    private bool $loggingMessageNotificationEnabled = false;
+    private bool $logging = true;
 
-    private ?LoggingLevel $currentLoggingMessageNotificationLevel = null;
+    private LoggingLevel $loggingLevel = LoggingLevel::Warning;
 
     public function __construct(
         private readonly ?EventDispatcherInterface $eventDispatcher = null,
@@ -77,21 +77,21 @@ public function __construct(
     }
 
     /**
-     * Enables logging message notifications for this registry.
+     * Disable logging message notifications for this registry.
      */
-    public function enableLoggingMessageNotification(): void
+    public function disableLogging(): void
     {
-        $this->loggingMessageNotificationEnabled = true;
+        $this->logging = false;
     }
 
     /**
      * Checks if logging message notification capability is enabled.
      *
-     * @return bool True if logging message notification capability is enabled, false otherwise
+     * @return bool True if logging capability is enabled, false otherwise
      */
-    public function isLoggingMessageNotificationEnabled(): bool
+    public function isLoggingEnabled(): bool
     {
-        return $this->loggingMessageNotificationEnabled;
+        return $this->logging;
     }
 
     /**
@@ -100,19 +100,19 @@ public function isLoggingMessageNotificationEnabled(): bool
      * This determines which log messages should be sent to the client.
      * Only messages at this level and higher (more severe) will be sent.
      */
-    public function setLoggingMessageNotificationLevel(LoggingLevel $level): void
+    public function setLoggingLevel(LoggingLevel $level): void
     {
-        $this->currentLoggingMessageNotificationLevel = $level;
+        $this->loggingLevel = $level;
     }
 
     /**
      * Gets the current logging message notification level set by the client.
      *
-     * @return LoggingLevel|null The current log level, or null if not set
+     * @return LoggingLevel The current log level
      */
-    public function getLoggingMessageNotificationLevel(): ?LoggingLevel
+    public function getLoggingLevel(): LoggingLevel
     {
-        return $this->currentLoggingMessageNotificationLevel;
+        return $this->loggingLevel;
     }
 
     public function getCapabilities(): ServerCapabilities
@@ -129,7 +129,7 @@ public function getCapabilities(): ServerCapabilities
             resourcesListChanged: $this->eventDispatcher instanceof EventDispatcherInterface,
             prompts: [] !== $this->prompts,
             promptsListChanged: $this->eventDispatcher instanceof EventDispatcherInterface,
-            logging: $this->loggingMessageNotificationEnabled,
+            logging: $this->logging,
             completions: true,
         );
     }

src/Capability/Registry/ReferenceProviderInterface.php

@@ -11,7 +11,6 @@
 
 namespace Mcp\Capability\Registry;
 
-use Mcp\Schema\Enum\LoggingLevel;
 use Mcp\Schema\Page;
 
 /**
@@ -66,34 +65,4 @@ public function getResourceTemplates(?int $limit = null, ?string $cursor = null)
      * Checks if any elements (manual or discovered) are currently registered.
      */
     public function hasElements(): bool;
-
-    /**
-     * Enables logging message notifications for the MCP server.
-     *
-     * When enabled, the server will advertise logging capability to clients,
-     * indicating that it can emit structured log messages according to the MCP specification.
-     */
-    public function enableLoggingMessageNotification(): void;
-
-    /**
-     * Checks if logging message notification capability is enabled.
-     *
-     * @return bool True if logging message notification capability is enabled, false otherwise
-     */
-    public function isLoggingMessageNotificationEnabled(): bool;
-
-    /**
-     * Sets the current logging message notification level for the client.
-     *
-     * This determines which log messages should be sent to the client.
-     * Only messages at this level and higher (more severe) will be sent.
-     */
-    public function setLoggingMessageNotificationLevel(LoggingLevel $level): void;
-
-    /**
-     * Gets the current logging message notification level set by the client.
-     *
-     * @return LoggingLevel|null The current log level, or null if not set
-     */
-    public function getLoggingMessageNotificationLevel(): ?LoggingLevel;
 }

src/Capability/Registry/ReferenceRegistryInterface.php

@@ -12,6 +12,7 @@
 namespace Mcp\Capability\Registry;
 
 use Mcp\Capability\Discovery\DiscoveryState;
+use Mcp\Schema\Enum\LoggingLevel;
 use Mcp\Schema\Prompt;
 use Mcp\Schema\Resource;
 use Mcp\Schema\ResourceTemplate;
@@ -88,4 +89,31 @@ public function getDiscoveryState(): DiscoveryState;
      * Manual elements are preserved.
      */
     public function setDiscoveryState(DiscoveryState $state): void;
+
+    /**
+     * Disables logging for the server.
+     */
+    public function disableLogging(): void;
+
+    /**
+     * Checks if logging capability is enabled.
+     *
+     * @return bool True if logging capability is enabled, false otherwise
+     */
+    public function isLoggingEnabled(): bool;
+
+    /**
+     * Sets the current logging level for the client.
+     *
+     * This determines which log messages should be sent to the client.
+     * Only messages at this level and higher (more severe) will be sent.
+     */
+    public function setLoggingLevel(LoggingLevel $level): void;
+
+    /**
+     * Gets the current logging level set by the client.
+     *
+     * @return LoggingLevel The current log level
+     */
+    public function getLoggingLevel(): LoggingLevel;
 }