feat: Use attributes to register routes

Author: butschster

context-generator

@@ -23,11 +23,14 @@ use Butschster\ContextGenerator\Lib\HttpClient\HttpClientInterface;
 use Butschster\ContextGenerator\Lib\Logger\ConsoleLogger;
 use Butschster\ContextGenerator\Lib\Logger\LoggerFactory;
 use Butschster\ContextGenerator\McpServer\Routing\McpResponseStrategy;
+use Butschster\ContextGenerator\McpServer\Routing\RouteRegistrar;
 use Butschster\ContextGenerator\Modifier\SourceModifierRegistry;
 use GuzzleHttp\Client;
 use GuzzleHttp\Psr7\HttpFactory;
+use League\Route\Router;
 use League\Route\Strategy\StrategyInterface;
 use Monolog\ErrorHandler;
+use Psr\Container\ContainerInterface;
 use Spiral\Core\Container;
 use Symfony\Component\Console\Application;
 use Symfony\Component\Console\Input\ArgvInput;
@@ -135,24 +138,34 @@ $container->bindSingleton(
     SourceModifierRegistry::class,
     static fn(ModifierRegistryFactory $factory) => $factory->create(),
 );
-$container->bindSingleton(HttpClientInterface::class, static function () {
-    $httpClient = new Client();
-    $httpMessageFactory = new HttpFactory();
-    return HttpClientFactory::create(
-        $httpClient,
-        $httpMessageFactory,
-    );
-});
+$container->bindSingleton(
+    HttpClientInterface::class,
+    static function (Client $httpClient, HttpFactory $httpMessageFactory) {
+        return HttpClientFactory::create(
+            $httpClient,
+            $httpMessageFactory,
+        );
+    },
+);
 $container->bindSingleton(RendererInterface::class, MarkdownRenderer::class);
 $container->bindSingleton(ContentBuilderFactory::class, ContentBuilderFactory::class);
-$container->bindSingleton(GithubClientInterface::class, static fn(
-    HttpClientInterface $httpClient,
-) => new GithubClientFactory(
-    httpClient: $httpClient,
-    defaultToken: \getenv('GITHUB_TOKEN') ?: null,
-));
+$container->bindSingleton(
+    GithubClientInterface::class,
+    static fn(HttpClientInterface $httpClient) => new GithubClientFactory(
+        httpClient: $httpClient,
+        defaultToken: \getenv('GITHUB_TOKEN') ?: null,
+    ),
+);
 
 $container->bindSingleton(LoggerFactory::class, LoggerFactory::class);
+$container->bindSingleton(Router::class, static function (StrategyInterface $strategy, ContainerInterface $container) {
+    $router = new Router();
+    $strategy->setContainer($container);
+    $router->setStrategy($strategy);
+
+    return $router;
+});
+$container->bindSingleton(RouteRegistrar::class, RouteRegistrar::class);
 
 // Register all commands
 $application->add(

context.yaml

@@ -259,6 +259,15 @@ documents:
         sourcePaths:
           - src/McpServer/Action
 
+  - description: "MCP Server routing"
+    outputPath: "mcp/routing.md"
+    sources:
+      - type: file
+        sourcePaths:
+          - src/McpServer/Routing
+          - src/McpServer/Server.php
+          - src/McpServer/ServerFactory.php
+
   - description: "Changes in the Project"
     outputPath: "changes.md"
     sources:

src/McpServer/Action/Prompts/GetPromptAction.php

@@ -4,6 +4,7 @@
 
 namespace Butschster\ContextGenerator\McpServer\Action\Prompts;
 
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Get;
 use Mcp\Types\GetPromptResult;
 use Mcp\Types\PromptMessage;
 use Mcp\Types\Role;
@@ -17,6 +18,7 @@ public function __construct(
         private LoggerInterface $logger,
     ) {}
 
+    #[Get(path: '/prompt/{name}', name: 'prompts.get')]
     public function __invoke(ServerRequestInterface $request): GetPromptResult
     {
         $name = $request->getAttribute('name');

src/McpServer/Action/Prompts/ListPromptsAction.php

@@ -4,6 +4,7 @@
 
 namespace Butschster\ContextGenerator\McpServer\Action\Prompts;
 
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Get;
 use Mcp\Types\ListPromptsResult;
 use Mcp\Types\Prompt;
 use Psr\Http\Message\ServerRequestInterface;
@@ -15,6 +16,7 @@ public function __construct(
         private LoggerInterface $logger,
     ) {}
 
+    #[Get(path: '/prompts/list', name: 'prompts.list')]
     public function __invoke(ServerRequestInterface $request): ListPromptsResult
     {
         $this->logger->info('Listing available prompts');

src/McpServer/Action/Resources/GetDocumentContentResourceAction.php

@@ -7,6 +7,7 @@
 use Butschster\ContextGenerator\ConfigLoader\ConfigLoaderInterface;
 use Butschster\ContextGenerator\Document\Compiler\DocumentCompiler;
 use Butschster\ContextGenerator\Document\Compiler\Error\ErrorCollection;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Get;
 use Mcp\Types\ReadResourceResult;
 use Mcp\Types\TextResourceContents;
 use Psr\Http\Message\ServerRequestInterface;
@@ -20,6 +21,7 @@ public function __construct(
         private DocumentCompiler $compiler,
     ) {}
 
+    #[Get(path: '/resource/ctx/document/{path:.*}', name: 'resources.ctx.document')]
     public function __invoke(ServerRequestInterface $request): ReadResourceResult
     {
         $path = $request->getAttribute('path');

src/McpServer/Action/Resources/GetJsonSchemaResourceAction.php

@@ -6,6 +6,7 @@
 
 use Butschster\ContextGenerator\Directories;
 use Butschster\ContextGenerator\FilesInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Get;
 use Mcp\Types\ReadResourceResult;
 use Mcp\Types\TextResourceContents;
 use Psr\Http\Message\ServerRequestInterface;
@@ -19,6 +20,7 @@ public function __construct(
         private Directories $dirs,
     ) {}
 
+    #[Get(path: '/resource/ctx/json-schema', name: 'resources.ctx.json-schema')]
     public function __invoke(ServerRequestInterface $request): ReadResourceResult
     {
         $this->logger->info('Getting JSON schema');

src/McpServer/Action/Resources/ListDocumentsResourceAction.php

@@ -5,6 +5,7 @@
 namespace Butschster\ContextGenerator\McpServer\Action\Resources;
 
 use Butschster\ContextGenerator\ConfigLoader\ConfigLoaderInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Get;
 use Mcp\Types\ReadResourceResult;
 use Mcp\Types\TextResourceContents;
 use Psr\Http\Message\ServerRequestInterface;
@@ -17,6 +18,7 @@ public function __construct(
         private ConfigLoaderInterface $configLoader,
     ) {}
 
+    #[Get(path: '/resource/ctx/list', name: 'resources.ctx.list')]
     public function __invoke(ServerRequestInterface $request): ReadResourceResult
     {
         $this->logger->info('Listing available documents');

src/McpServer/Action/Resources/ListResourcesAction.php

@@ -5,6 +5,7 @@
 namespace Butschster\ContextGenerator\McpServer\Action\Resources;
 
 use Butschster\ContextGenerator\ConfigLoader\ConfigLoaderInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Get;
 use Mcp\Types\ListResourcesResult;
 use Mcp\Types\Resource;
 use Psr\Http\Message\ServerRequestInterface;
@@ -17,6 +18,7 @@ public function __construct(
         private ConfigLoaderInterface $configLoader,
     ) {}
 
+    #[Get(path: '/resources/list', name: 'resources.list')]
     public function __invoke(ServerRequestInterface $request): ListResourcesResult
     {
         $this->logger->info('Listing available resources');

src/McpServer/Action/RouteProvider.php

@@ -5,6 +5,7 @@
 namespace Butschster\ContextGenerator\McpServer\Action\Tools\Context;
 
 use Butschster\ContextGenerator\ConfigLoader\ConfigLoaderInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Post;
 use Mcp\Types\CallToolResult;
 use Mcp\Types\TextContent;
 use Psr\Http\Message\ServerRequestInterface;
@@ -17,6 +18,7 @@ public function __construct(
         private ConfigLoaderInterface $configLoader,
     ) {}
 
+    #[Post(path: '/tools/call/context', name: 'tools.context.list')]
     public function __invoke(ServerRequestInterface $request): CallToolResult
     {
         $this->logger->info('Processing context tool');

src/McpServer/Action/Tools/Context/ContextAction.php

@@ -7,6 +7,7 @@
 use Butschster\ContextGenerator\ConfigLoader\ConfigLoaderInterface;
 use Butschster\ContextGenerator\Document\Compiler\DocumentCompiler;
 use Butschster\ContextGenerator\Document\Compiler\Error\ErrorCollection;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Post;
 use Mcp\Types\CallToolResult;
 use Mcp\Types\TextContent;
 use Psr\Http\Message\ServerRequestInterface;
@@ -20,6 +21,7 @@ public function __construct(
         private DocumentCompiler $documentCompiler,
     ) {}
 
+    #[Post(path: '/tools/call/context-get', name: 'tools.context.get')]
     public function __invoke(ServerRequestInterface $request): CallToolResult
     {
         $this->logger->info('Processing context-get tool');

src/McpServer/Action/Tools/Context/ContextGetAction.php

@@ -8,6 +8,7 @@
 use Butschster\ContextGenerator\Directories;
 use Butschster\ContextGenerator\Document\Compiler\DocumentCompiler;
 use Butschster\ContextGenerator\Document\Compiler\Error\ErrorCollection;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Post;
 use Laminas\Diactoros\Response\JsonResponse;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
@@ -22,6 +23,7 @@ public function __construct(
         private Directories $dirs,
     ) {}
 
+    #[Post(path: '/tools/call/context-request', name: 'tools.context.request')]
     public function __invoke(ServerRequestInterface $request): ResponseInterface
     {
         $this->logger->info('Handling context-request action');

src/McpServer/Action/Tools/Context/ContextRequestAction.php

@@ -6,6 +6,7 @@
 
 use Butschster\ContextGenerator\Directories;
 use Butschster\ContextGenerator\FilesInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Post;
 use Mcp\Types\CallToolResult;
 use Mcp\Types\TextContent;
 use Psr\Http\Message\ServerRequestInterface;
@@ -19,6 +20,7 @@ public function __construct(
         private Directories $dirs,
     ) {}
 
+    #[Post(path: '/tools/call/file-info', name: 'tools.file-info')]
     public function __invoke(ServerRequestInterface $request): CallToolResult
     {
         $this->logger->info('Processing file-info tool');

src/McpServer/Action/Tools/Filesystem/FileInfoAction.php

@@ -6,6 +6,7 @@
 
 use Butschster\ContextGenerator\Directories;
 use Butschster\ContextGenerator\FilesInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Post;
 use Mcp\Types\CallToolResult;
 use Mcp\Types\TextContent;
 use Psr\Http\Message\ServerRequestInterface;
@@ -19,6 +20,7 @@ public function __construct(
         private Directories $dirs,
     ) {}
 
+    #[Post(path: '/tools/call/file-move', name: 'tools.file-move')]
     public function __invoke(ServerRequestInterface $request): CallToolResult
     {
         $this->logger->info('Processing file-move tool');

src/McpServer/Action/Tools/Filesystem/FileMoveAction.php

@@ -6,11 +6,13 @@
 
 use Butschster\ContextGenerator\Directories;
 use Butschster\ContextGenerator\FilesInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Post;
 use Mcp\Types\CallToolResult;
 use Mcp\Types\TextContent;
 use Psr\Http\Message\ServerRequestInterface;
 use Psr\Log\LoggerInterface;
 
+#[Controller(prefix: '/tools/call')]
 final readonly class FileReadAction
 {
     public function __construct(
@@ -19,6 +21,7 @@ public function __construct(
         private Directories $dirs,
     ) {}
 
+    #[Post(path: 'file-read', name: 'tools.file-read')]
     public function __invoke(ServerRequestInterface $request): CallToolResult
     {
         $this->logger->info('Processing file-read tool');

src/McpServer/Action/Tools/Filesystem/FileReadAction.php

@@ -6,6 +6,7 @@
 
 use Butschster\ContextGenerator\Directories;
 use Butschster\ContextGenerator\FilesInterface;
+use Butschster\ContextGenerator\McpServer\Routing\Attribute\Post;
 use Mcp\Types\CallToolResult;
 use Mcp\Types\TextContent;
 use Psr\Http\Message\ServerRequestInterface;
@@ -19,6 +20,7 @@ public function __construct(
         private Directories $dirs,
     ) {}
 
+    #[Post(path: '/tools/call/file-rename', name: 'tools.file-rename')]
     public function __invoke(ServerRequestInterface $request): CallToolResult
     {
         $this->logger->info('Processing file-rename tool');