Add more inspector tests for functionality tests of STDIO examples

chr-hertel · chr-hertel · commit 88403cf28d1f · 2025-10-26T23:25:50.000+01:00
diff --git a/examples/stdio-custom-dependencies/McpTaskHandlers.php b/examples/stdio-custom-dependencies/McpTaskHandlers.php
@@ -13,8 +13,8 @@
 
 use Mcp\Capability\Attribute\McpResource;
 use Mcp\Capability\Attribute\McpTool;
-use Mcp\Example\DependenciesStdioExample\Service\StatsServiceInterface;
-use Mcp\Example\DependenciesStdioExample\Service\TaskRepositoryInterface;
+use Mcp\Example\StdioCustomDependencies\Service\StatsServiceInterface;
+use Mcp\Example\StdioCustomDependencies\Service\TaskRepositoryInterface;
 use Psr\Log\LoggerInterface;
 
 /**
diff --git a/examples/stdio-custom-dependencies/Service/InMemoryTaskRepository.php b/examples/stdio-custom-dependencies/Service/InMemoryTaskRepository.php
@@ -9,7 +9,7 @@
  * file that was distributed with this source code.
  */
 
-namespace Mcp\Example\DependenciesStdioExample\Service;
+namespace Mcp\Example\StdioCustomDependencies\Service;
 
 use Psr\Log\LoggerInterface;
 
diff --git a/examples/stdio-custom-dependencies/Service/StatsServiceInterface.php b/examples/stdio-custom-dependencies/Service/StatsServiceInterface.php
@@ -9,7 +9,7 @@
  * file that was distributed with this source code.
  */
 
-namespace Mcp\Example\DependenciesStdioExample\Service;
+namespace Mcp\Example\StdioCustomDependencies\Service;
 
 interface StatsServiceInterface
 {
diff --git a/examples/stdio-custom-dependencies/Service/SystemStatsService.php b/examples/stdio-custom-dependencies/Service/SystemStatsService.php
@@ -9,7 +9,7 @@
  * file that was distributed with this source code.
  */
 
-namespace Mcp\Example\DependenciesStdioExample\Service;
+namespace Mcp\Example\StdioCustomDependencies\Service;
 
 final class SystemStatsService implements StatsServiceInterface
 {
diff --git a/examples/stdio-custom-dependencies/Service/TaskRepositoryInterface.php b/examples/stdio-custom-dependencies/Service/TaskRepositoryInterface.php
@@ -9,7 +9,7 @@
  * file that was distributed with this source code.
  */
 
-namespace Mcp\Example\DependenciesStdioExample\Service;
+namespace Mcp\Example\StdioCustomDependencies\Service;
 
 /**
  * @phpstan-type Task array{id: int, userId: string, description: string, completed: bool, createdAt: string}
diff --git a/examples/stdio-custom-dependencies/server.php b/examples/stdio-custom-dependencies/server.php
@@ -13,10 +13,10 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 chdir(__DIR__);
 
-use Mcp\Example\DependenciesStdioExample\Service\InMemoryTaskRepository;
-use Mcp\Example\DependenciesStdioExample\Service\StatsServiceInterface;
-use Mcp\Example\DependenciesStdioExample\Service\SystemStatsService;
-use Mcp\Example\DependenciesStdioExample\Service\TaskRepositoryInterface;
+use Mcp\Example\StdioCustomDependencies\Service\InMemoryTaskRepository;
+use Mcp\Example\StdioCustomDependencies\Service\StatsServiceInterface;
+use Mcp\Example\StdioCustomDependencies\Service\SystemStatsService;
+use Mcp\Example\StdioCustomDependencies\Service\TaskRepositoryInterface;
 use Mcp\Server;
 use Mcp\Server\Transport\StdioTransport;
 
diff --git a/tests/Inspector/StdioCachedDiscoveryTest.php b/tests/Inspector/StdioCachedDiscoveryTest.php
@@ -0,0 +1,29 @@
+<?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 Inspector;
+
+use Mcp\Tests\Inspector\InspectorSnapshotTestCase;
+
+final class StdioCachedDiscoveryTest extends InspectorSnapshotTestCase
+{
+    public static function provideMethods(): array
+    {
+        return [
+            ...parent::provideListMethods(),
+        ];
+    }
+
+    protected function getServerScript(): string
+    {
+        return \dirname(__DIR__, 2).'/examples/stdio-cached-discovery/server.php';
+    }
+}
diff --git a/tests/Inspector/StdioCustomDependenciesTest.php b/tests/Inspector/StdioCustomDependenciesTest.php
@@ -0,0 +1,29 @@
+<?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 Inspector;
+
+use Mcp\Tests\Inspector\InspectorSnapshotTestCase;
+
+final class StdioCustomDependenciesTest extends InspectorSnapshotTestCase
+{
+    public static function provideMethods(): array
+    {
+        return [
+            ...parent::provideListMethods(),
+        ];
+    }
+
+    protected function getServerScript(): string
+    {
+        return \dirname(__DIR__, 2).'/examples/stdio-custom-dependencies/server.php';
+    }
+}
diff --git a/tests/Inspector/StdioDiscoveryCalculatorTest.php b/tests/Inspector/StdioDiscoveryCalculatorTest.php
@@ -11,7 +11,7 @@
 
 namespace Mcp\Tests\Inspector;
 
-final class StdioCalculatorExampleTest extends InspectorSnapshotTestCase
+final class StdioDiscoveryCalculatorTest extends InspectorSnapshotTestCase
 {
     public static function provideMethods(): array
     {
diff --git a/tests/Inspector/StdioEnvVariablesTest.php b/tests/Inspector/StdioEnvVariablesTest.php
@@ -0,0 +1,29 @@
+<?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 Inspector;
+
+use Mcp\Tests\Inspector\InspectorSnapshotTestCase;
+
+final class StdioEnvVariablesTest extends InspectorSnapshotTestCase
+{
+    public static function provideMethods(): array
+    {
+        return [
+            ...parent::provideListMethods(),
+        ];
+    }
+
+    protected function getServerScript(): string
+    {
+        return \dirname(__DIR__, 2).'/examples/stdio-env-variables/server.php';
+    }
+}
diff --git a/tests/Inspector/StdioExplicitRegistrationTest.php b/tests/Inspector/StdioExplicitRegistrationTest.php
@@ -13,7 +13,7 @@
 
 use Mcp\Tests\Inspector\InspectorSnapshotTestCase;
 
-final class ManualStdioExampleTest extends InspectorSnapshotTestCase
+final class StdioExplicitRegistrationTest extends InspectorSnapshotTestCase
 {
     public static function provideMethods(): array
     {
diff --git a/tests/Inspector/snapshots/StdioCachedDiscoveryTest-prompts_list.json b/tests/Inspector/snapshots/StdioCachedDiscoveryTest-prompts_list.json
@@ -1,4 +1,3 @@
 {
   "prompts": []
 }
-
diff --git a/tests/Inspector/snapshots/StdioCachedDiscoveryTest-resources_list.json b/tests/Inspector/snapshots/StdioCachedDiscoveryTest-resources_list.json
@@ -0,0 +1,3 @@
+{
+  "resources": []
+}
diff --git a/tests/Inspector/snapshots/StdioCachedDiscoveryTest-resources_templates_list.json b/tests/Inspector/snapshots/StdioCachedDiscoveryTest-resources_templates_list.json
diff --git a/tests/Inspector/snapshots/StdioCachedDiscoveryTest-tools_list.json b/tests/Inspector/snapshots/StdioCachedDiscoveryTest-tools_list.json
@@ -0,0 +1,76 @@
+{
+  "tools": [
+    {
+      "name": "add_numbers",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "integer"
+          },
+          "b": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "a",
+          "b"
+        ]
+      }
+    },
+    {
+      "name": "multiply_numbers",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "integer"
+          },
+          "b": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "a",
+          "b"
+        ]
+      }
+    },
+    {
+      "name": "divide_numbers",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "integer"
+          },
+          "b": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "a",
+          "b"
+        ]
+      }
+    },
+    {
+      "name": "power",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "base": {
+            "type": "integer"
+          },
+          "exponent": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "base",
+          "exponent"
+        ]
+      }
+    }
+  ]
+}
diff --git a/tests/Inspector/snapshots/StdioCustomDependenciesTest-prompts_list.json b/tests/Inspector/snapshots/StdioCustomDependenciesTest-prompts_list.json
@@ -0,0 +1,3 @@
+{
+  "prompts": []
+}
diff --git a/tests/Inspector/snapshots/StdioCustomDependenciesTest-resources_list.json b/tests/Inspector/snapshots/StdioCustomDependenciesTest-resources_list.json
@@ -0,0 +1,10 @@
+{
+  "resources": [
+    {
+      "name": "system_stats",
+      "uri": "stats://system/overview",
+      "description": "Provides current system statistics.",
+      "mimeType": "application/json"
+    }
+  ]
+}
diff --git a/tests/Inspector/snapshots/StdioCustomDependenciesTest-resources_templates_list.json b/tests/Inspector/snapshots/StdioCustomDependenciesTest-resources_templates_list.json
@@ -0,0 +1,3 @@
+{
+  "resourceTemplates": []
+}
diff --git a/tests/Inspector/snapshots/StdioCustomDependenciesTest-tools_list.json b/tests/Inspector/snapshots/StdioCustomDependenciesTest-tools_list.json
@@ -0,0 +1,57 @@
+{
+  "tools": [
+    {
+      "name": "add_task",
+      "description": "Adds a new task for a given user.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "the ID of the user"
+          },
+          "description": {
+            "type": "string",
+            "description": "the task description"
+          }
+        },
+        "required": [
+          "userId",
+          "description"
+        ]
+      }
+    },
+    {
+      "name": "list_user_tasks",
+      "description": "Lists pending tasks for a specific user.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "the ID of the user"
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
+    },
+    {
+      "name": "complete_task",
+      "description": "Marks a task as complete.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": {
+            "type": "integer",
+            "description": "the ID of the task to complete"
+          }
+        },
+        "required": [
+          "taskId"
+        ]
+      }
+    }
+  ]
+}
diff --git a/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-prompts_list.json b/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-prompts_list.json
@@ -0,0 +1,3 @@
+{
+  "prompts": []
+}
diff --git a/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-resources_list.json b/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-resources_list.json
@@ -8,4 +8,3 @@
     }
   ]
 }
-
diff --git a/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-resources_read.json b/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-resources_read.json
diff --git a/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-resources_templates_list.json b/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-resources_templates_list.json
@@ -0,0 +1,3 @@
+{
+  "resourceTemplates": []
+}
diff --git a/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-tools_call.json b/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-tools_call.json
diff --git a/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-tools_list.json b/tests/Inspector/snapshots/StdioDiscoveryCalculatorTest-tools_list.json
@@ -48,4 +48,3 @@
     }
   ]
 }
-
diff --git a/tests/Inspector/snapshots/StdioEnvVariablesTest-prompts_list.json b/tests/Inspector/snapshots/StdioEnvVariablesTest-prompts_list.json
@@ -0,0 +1,3 @@
+{
+  "prompts": []
+}
diff --git a/tests/Inspector/snapshots/StdioEnvVariablesTest-resources_list.json b/tests/Inspector/snapshots/StdioEnvVariablesTest-resources_list.json
@@ -0,0 +1,3 @@
+{
+  "resources": []
+}
diff --git a/tests/Inspector/snapshots/StdioEnvVariablesTest-resources_templates_list.json b/tests/Inspector/snapshots/StdioEnvVariablesTest-resources_templates_list.json
@@ -0,0 +1,3 @@
+{
+  "resourceTemplates": []
+}
diff --git a/tests/Inspector/snapshots/StdioEnvVariablesTest-tools_list.json b/tests/Inspector/snapshots/StdioEnvVariablesTest-tools_list.json
@@ -0,0 +1,20 @@
+{
+  "tools": [
+    {
+      "name": "process_data_by_mode",
+      "description": "Performs an action that can be modified by an environment variable.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "input": {
+            "type": "string",
+            "description": "some input data"
+          }
+        },
+        "required": [
+          "input"
+        ]
+      }
+    }
+  ]
+}
diff --git a/tests/Inspector/snapshots/StdioExplicitRegistrationTest-prompts_list.json b/tests/Inspector/snapshots/StdioExplicitRegistrationTest-prompts_list.json
diff --git a/tests/Inspector/snapshots/StdioExplicitRegistrationTest-resources_list.json b/tests/Inspector/snapshots/StdioExplicitRegistrationTest-resources_list.json
diff --git a/tests/Inspector/snapshots/StdioExplicitRegistrationTest-resources_templates_list.json b/tests/Inspector/snapshots/StdioExplicitRegistrationTest-resources_templates_list.json
diff --git a/tests/Inspector/snapshots/StdioExplicitRegistrationTest-tools_list.json b/tests/Inspector/snapshots/StdioExplicitRegistrationTest-tools_list.json

Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@`
`9`	`9`	`* file that was distributed with this source code.`
`10`	`10`	`*/`
`11`	`11`
`12`		`-namespace Mcp\Example\DependenciesStdioExample\Service;`
	`12`	`+namespace Mcp\Example\StdioCustomDependencies\Service;`
`13`	`13`
`14`	`14`	`interface StatsServiceInterface`
`15`	`15`	`{`
Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,7 @@`
`11`	`11`
`12`	`12`	`namespace Mcp\Tests\Inspector;`
`13`	`13`
`14`		`-final class StdioCalculatorExampleTest extends InspectorSnapshotTestCase`
	`14`	`+final class StdioDiscoveryCalculatorTest extends InspectorSnapshotTestCase`
`15`	`15`	`{`
`16`	`16`	`public static function provideMethods(): array`
`17`	`17`	`{`