feat: add MCP project management tools

Author: butschster

src/McpServer/McpConfig.php

@@ -37,6 +37,9 @@ final class McpConfig extends InjectableConfig
         'git_operations' => [
             'enable' => true,
         ],
+        'project_operations' => [
+            'enable' => true,
+        ],
     ];
 
     public function getDocumentNameFormat(string $path, string $description, string $tags): string
@@ -97,4 +100,9 @@ public function isGitOperationsEnabled(): bool
     {
         return $this->config['git_operations']['enable'] ?? true;
     }
+
+    public function isProjectOperationsEnabled(): bool
+    {
+        return $this->config['project_operations']['enable'] ?? true;
+    }
 }

src/McpServer/McpServerBootloader.php

@@ -32,6 +32,8 @@
 use Butschster\ContextGenerator\McpServer\Action\Tools\Prompts\GetPromptToolAction;
 use Butschster\ContextGenerator\McpServer\Action\Tools\Prompts\ListPromptsToolAction;
 use Butschster\ContextGenerator\McpServer\Console\MCPServerCommand;
+use Butschster\ContextGenerator\McpServer\Projects\Actions\ProjectsListToolAction;
+use Butschster\ContextGenerator\McpServer\Projects\Actions\ProjectSwitchToolAction;
 use Butschster\ContextGenerator\McpServer\Projects\McpProjectsBootloader;
 use Butschster\ContextGenerator\McpServer\ProjectService\ProjectServiceInterface;
 use Butschster\ContextGenerator\McpServer\Prompt\McpPromptBootloader;
@@ -98,6 +100,9 @@ public function init(EnvironmentInterface $env): void
                 'git_operations' => [
                     'enable' => (bool) $env->get('MCP_GIT_OPERATIONS', !$isCommonProject),
                 ],
+                'project_operations' => [
+                    'enable' => (bool) $env->get('MCP_PROJECT_OPERATIONS', true),
+                ],
             ],
         );
     }
@@ -189,6 +194,7 @@ private function actions(McpConfig $config): array
                 FetchLibraryDocsAction::class,
             ];
         }
+
         if ($config->isFileOperationsEnabled()) {
             $actions = [
                 ...$actions,
@@ -209,6 +215,14 @@ private function actions(McpConfig $config): array
             }
         }
 
+        if ($config->isProjectOperationsEnabled()) {
+            $actions = [
+                ...$actions,
+                ProjectsListToolAction::class,
+                ProjectSwitchToolAction::class,
+            ];
+        }
+
         if ($config->isGitOperationsEnabled()) {
             $actions[] = GitStatusAction::class;
             $actions[] = GitAddAction::class;

src/McpServer/Projects/Actions/Dto/AliasResolutionResponse.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\McpServer\Projects\Actions\Dto;
+
+/**
+ * Response when alias resolution occurs
+ */
+final readonly class AliasResolutionResponse implements \JsonSerializable
+{
+    public function __construct(
+        public string $originalAlias,
+        public string $resolvedPath,
+    ) {}
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'original_alias' => $this->originalAlias,
+            'resolved_path' => $this->resolvedPath,
+        ];
+    }
+}

src/McpServer/Projects/Actions/Dto/CurrentProjectResponse.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\McpServer\Projects\Actions\Dto;
+
+/**
+ * Represents current project information in response
+ */
+final readonly class CurrentProjectResponse implements \JsonSerializable
+{
+    /**
+     * @param string[] $aliases
+     */
+    public function __construct(
+        public string $path,
+        public ?string $configFile,
+        public ?string $envFile,
+        public array $aliases,
+    ) {}
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'path' => $this->path,
+            'config_file' => $this->configFile,
+            'env_file' => $this->envFile,
+            'aliases' => $this->aliases,
+        ];
+    }
+}

src/McpServer/Projects/Actions/Dto/ProjectInfoResponse.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\McpServer\Projects\Actions\Dto;
+
+/**
+ * Represents a single project in the response
+ */
+final readonly class ProjectInfoResponse implements \JsonSerializable
+{
+    /**
+     * @param string[] $aliases
+     */
+    public function __construct(
+        public string $path,
+        public ?string $configFile,
+        public ?string $envFile,
+        public string $addedAt,
+        public array $aliases,
+        public bool $isCurrent,
+    ) {}
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'path' => $this->path,
+            'config_file' => $this->configFile,
+            'env_file' => $this->envFile,
+            'added_at' => $this->addedAt,
+            'aliases' => $this->aliases,
+            'is_current' => $this->isCurrent,
+        ];
+    }
+}

src/McpServer/Projects/Actions/Dto/ProjectListRequest.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\McpServer\Projects\Actions\Dto;
+
+final readonly class ProjectListRequest
+{
+    public function __construct(
+        // No parameters needed for listing projects
+    ) {}
+}

src/McpServer/Projects/Actions/Dto/ProjectSwitchRequest.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\McpServer\Projects\Actions\Dto;
+
+use Spiral\JsonSchemaGenerator\Attribute\Field;
+
+final readonly class ProjectSwitchRequest
+{
+    public function __construct(
+        #[Field(
+            description: 'Alias to the project to switch to. Should be project alias.',
+        )]
+        public string $alias,
+    ) {}
+}

src/McpServer/Projects/Actions/Dto/ProjectSwitchResponse.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\McpServer\Projects\Actions\Dto;
+
+/**
+ * Response for project switch tool
+ */
+final readonly class ProjectSwitchResponse implements \JsonSerializable
+{
+    public function __construct(
+        public bool $success,
+        public string $message,
+        public ?CurrentProjectResponse $currentProject = null,
+        public ?AliasResolutionResponse $resolvedFromAlias = null,
+    ) {}
+
+    public function jsonSerialize(): array
+    {
+        return \array_filter([
+            'success' => $this->success,
+            'message' => $this->message,
+            'current_project' => $this->currentProject,
+            'resolved_from_alias' => $this->resolvedFromAlias,
+        ], static fn($value) => $value !== null);
+    }
+}

src/McpServer/Projects/Actions/Dto/ProjectsListResponse.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\McpServer\Projects\Actions\Dto;
+
+/**
+ * Response for projects list tool
+ */
+final readonly class ProjectsListResponse implements \JsonSerializable
+{
+    /**
+     * @param ProjectInfoResponse[] $projects
+     */
+    public function __construct(
+        public array $projects,
+        public ?CurrentProjectResponse $currentProject,
+        public int $totalProjects,
+        public ?string $message = null,
+    ) {}
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'projects' => $this->projects,
+            'current_project' => $this->currentProject,
+            'total_projects' => $this->totalProjects,
+            'message' => $this->message,
+        ];
+    }
+}