feat: add 'application info' tool

Author: ashleyhindle

src/Mcp/Tools/ApplicationInfo.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Laravel\Boost\Mcp\Tools;
+
+use Laravel\Mcp\Server\Tool;
+use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
+use Laravel\Mcp\Server\Tools\ToolInputSchema;
+use Laravel\Mcp\Server\Tools\ToolResult;
+use Laravel\Roster\Roster;
+
+#[IsReadOnly]
+class ApplicationInfo extends Tool
+{
+    public function __construct(protected Roster $roster)
+    {
+    }
+
+    public function description(): string
+    {
+        return 'Get comprehensive application information including PHP version, Laravel version, database engine, and all installed packages with their versions. You should use this tool on each new chat, and use the package & version data to write version specific code for the packages that exist.';
+    }
+
+    public function schema(ToolInputSchema $schema): ToolInputSchema
+    {
+        return $schema;
+    }
+
+    /**
+     * @param array<string> $arguments
+     */
+    public function handle(array $arguments): ToolResult
+    {
+        $packages = [];
+        foreach ($this->roster->packages() as $package) {
+            $packages[] = [
+                'name' => $package->name(),
+                'version' => $package->version(),
+            ];
+        }
+
+        return ToolResult::json([
+            'php_version' => PHP_VERSION,
+            'laravel_version' => app()->version(),
+            'database_engine' => config('database.default'),
+            'packages' => $packages,
+        ]);
+    }
+}

tests/Feature/Mcp/Tools/ApplicationInfoTest.php

@@ -0,0 +1,55 @@
+<?php
+
+use Laravel\Boost\Mcp\Tools\ApplicationInfo;
+use Laravel\Mcp\Server\Tools\ToolResult;
+use Laravel\Roster\Enums\Packages;
+use Laravel\Roster\Package;
+use Laravel\Roster\Roster;
+
+test('it returns application info with packages', function () {
+    $packages = collect([
+        new Package(Packages::LARAVEL, '11.0.0'),
+        new Package(Packages::PEST, '2.0.0'),
+    ]);
+
+    $roster = Mockery::mock(Roster::class);
+    $roster->shouldReceive('packages')->andReturn($packages);
+
+    $tool = new ApplicationInfo($roster);
+    $result = $tool->handle([]);
+
+    expect($result)->toBeInstanceOf(ToolResult::class);
+
+    $data = $result->toArray();
+    expect($data['isError'])->toBeFalse();
+
+    $content = json_decode($data['content'][0]['text'], true);
+    expect($content['php_version'])->toBe(PHP_VERSION);
+    expect($content['laravel_version'])->toBe(app()->version());
+    expect($content['database_engine'])->toBe(config('database.default'));
+    expect($content['packages'])->toHaveCount(2);
+    expect($content['packages'][0]['name'])->toBe('LARAVEL');
+    expect($content['packages'][0]['version'])->toBe('11.0.0');
+    expect($content['packages'][1]['name'])->toBe('PEST');
+    expect($content['packages'][1]['version'])->toBe('2.0.0');
+});
+
+test('it returns application info with no packages', function () {
+    $roster = Mockery::mock(Roster::class);
+    $roster->shouldReceive('packages')->andReturn(collect([]));
+
+    $tool = new ApplicationInfo($roster);
+    $result = $tool->handle([]);
+
+    expect($result)->toBeInstanceOf(ToolResult::class);
+    expect($result)->toBeInstanceOf(ToolResult::class);
+
+    $data = $result->toArray();
+    expect($data['isError'])->toBeFalse();
+
+    $content = json_decode($data['content'][0]['text'], true);
+    expect($content['php_version'])->toBe(PHP_VERSION);
+    expect($content['laravel_version'])->toBe(app()->version());
+    expect($content['database_engine'])->toBe(config('database.default'));
+    expect($content['packages'])->toHaveCount(0);
+});