Add happy cases for functional tests of example 1

Author: chr-hertel

tests/Inspector/InspectorSnapshotTestCase.php

@@ -17,14 +17,41 @@
 
 abstract class InspectorSnapshotTestCase extends TestCase
 {
+    /**
+     * @param array<string, mixed> $toolArgs
+     */
     #[DataProvider('provideMethods')]
-    public function testResourcesListOutputMatchesSnapshot(string $method): void
-    {
-        $process = Process::fromShellCommandline(
-            \sprintf('npx @modelcontextprotocol/inspector --cli php %s --method %s', $this->getServerScript(), $method)
-        )->mustRun();
+    public function testResourcesListOutputMatchesSnapshot(
+        string $method,
+        ?string $toolName = null,
+        array $toolArgs = [],
+        ?string $uri = null,
+    ): void {
+        $args = [
+            'npx', '@modelcontextprotocol/inspector', '--cli', 'php', $this->getServerScript(), '--method', $method,
+        ];
+
+        // Options for tools/call
+        if (null !== $toolName) {
+            $args[] = '--tool-name';
+            $args[] = $toolName;
+
+            foreach ($toolArgs as $key => $value) {
+                $args[] = '--tool-arg';
+                $args[] = \sprintf('%s=%s', $key, $value);
+            }
+        }
+
+        // Options for resources/read
+        if (null !== $uri) {
+            $args[] = '--uri';
+            $args[] = $uri;
+        }
+
+        $output = (new Process($args))
+            ->mustRun()
+            ->getOutput();
 
-        $output = $process->getOutput();
         $snapshotFile = $this->getSnapshotFilePath($method);
 
         if (!file_exists($snapshotFile)) {

tests/Inspector/StdioCalculatorExampleTest.php

@@ -17,6 +17,17 @@ public static function provideMethods(): array
     {
         return [
             ...parent::provideListMethods(),
+            'Calculate Sum' => [
+                'method' => 'tools/call',
+                'toolName' => 'calculate',
+                'toolArgs' => ['a' => 12.5, 'b' => 7.3, 'operation' => 'add'],
+            ],
+            'Read Config' => [
+                'method' => 'resources/read',
+                'toolName' => null, // can be removed with newer PHPUnit versions
+                'toolArgs' => [], // can be removed with newer PHPUnit versions
+                'uri' => 'config://calculator/settings',
+            ],
         ];
     }
 

tests/Inspector/snapshots/StdioCalculatorExampleTest-resources_read.json

@@ -0,0 +1,9 @@
+{
+  "contents": [
+    {
+      "uri": "config://calculator/settings",
+      "mimeType": "application/json",
+      "text": "{\n    \"precision\": 2,\n    \"allow_negative\": true\n}"
+    }
+  ]
+}

tests/Inspector/snapshots/StdioCalculatorExampleTest-tools_call.json

@@ -0,0 +1,9 @@
+{
+  "content": [
+    {
+      "type": "text",
+      "text": "19.8"
+    }
+  ],
+  "isError": false
+}