Nomad changes

2026-06-01 23:40:55 +02:00
parent 72b1a0a6ed
commit b4c07d3693
5723 changed files with 1130655 additions and 0 deletions
--- a/docs/snippets/php/mcp/mcp_http_client.md
+++ b/docs/snippets/php/mcp/mcp_http_client.md
@@ -0,0 +1,132 @@
+```php title="PHP"
+<?php
+
+declare(strict_types=1);
+
+use GuzzleHttp\Client;
+use GuzzleHttp\Exception\GuzzleException;
+
+/**
+ * Connect to Kreuzberg MCP server via HTTP transport.
+ *
+ * Requires MCP server running with HTTP transport:
+ * kreuzberg mcp --transport http --port 3000
+ */
+final readonly class KreuzbergMcpClient
+{
+    private Client $http;
+
+    public function __construct(
+        private string $baseUrl = 'http://localhost:3000',
+    ) {
+        $this->http = new Client([
+            'base_uri' => $this->baseUrl,
+            'timeout' => 30.0,
+            'headers' => [
+                'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
+            ],
+        ]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     * @throws GuzzleException
+     */
+    public function initialize(): array
+    {
+        $response = $this->http->post('/initialize', [
+            'json' => [
+                'protocolVersion' => '2024-11-05',
+                'capabilities' => [],
+                'clientInfo' => [
+                    'name' => 'kreuzberg-php-client',
+                    'version' => '4.2.7',
+                ],
+            ],
+        ]);
+
+        return json_decode($response->getBody()->getContents(), true, 512, JSON_THROW_ON_ERROR);
+    }
+
+    /**
+     * @return array<int, array{name: string, description: string, inputSchema: array<string, mixed>}>
+     * @throws GuzzleException
+     */
+    public function listTools(): array
+    {
+        $response = $this->http->post('/tools/list');
+        $data = json_decode($response->getBody()->getContents(), true, 512, JSON_THROW_ON_ERROR);
+
+        return $data['tools'] ?? [];
+    }
+
+    /**
+     * @param array<string, mixed> $arguments
+     * @return array<string, mixed>
+     * @throws GuzzleException
+     */
+    public function callTool(string $toolName, array $arguments): array
+    {
+        $response = $this->http->post('/tools/call', [
+            'json' => [
+                'name' => $toolName,
+                'arguments' => $arguments,
+            ],
+        ]);
+
+        return json_decode($response->getBody()->getContents(), true, 512, JSON_THROW_ON_ERROR);
+    }
+
+    /**
+     * @param array<string, mixed>|null $config
+     * @return array<string, mixed>
+     * @throws GuzzleException
+     */
+    public function extractFile(string $path, ?array $config = null): array
+    {
+        return $this->callTool('extract_file', [
+            'path' => $path,
+            'config' => $config,
+        ]);
+    }
+
+    /**
+     * @param array<int, string> $paths
+     * @param array<string, mixed>|null $config
+     * @return array<string, mixed>
+     * @throws GuzzleException
+     */
+    public function batchExtractFiles(array $paths, ?array $config = null): array
+    {
+        return $this->callTool('batch_extract_files', [
+            'paths' => $paths,
+            'config' => $config,
+        ]);
+    }
+}
+
+// Usage
+$client = new KreuzbergMcpClient('http://localhost:3000');
+
+// Initialize connection
+$serverInfo = $client->initialize();
+echo "Connected to: {$serverInfo['serverInfo']['name']}\n";
+
+// List available tools
+$tools = $client->listTools();
+$toolNames = array_column($tools, 'name');
+echo "Available tools: " . implode(', ', $toolNames) . "\n";
+
+// Extract a file
+$result = $client->extractFile('document.pdf');
+echo "Extracted content length: " . strlen($result['content']) . "\n";
+
+// Batch extract
+$results = $client->batchExtractFiles([
+    'file1.pdf',
+    'file2.docx',
+    'file3.md',
+]);
+echo "Batch extracted " . count($results) . " files\n";
+```