Add MCP server (#176)

Author: ArthurJCQ

.env

@@ -55,7 +55,7 @@ MERCURE_JWT_SECRET=dev-@1123581321-killer-mercure-secret
 ###< symfony/mercure-bundle ###
 
 ###> symfony/expo-notifier ###
- EXPO_DSN=expo://TOKEN@default
+EXPO_DSN=expo://TOKEN@default
 ###< symfony/expo-notifier ###
 
 ###> sentry/sentry-symfony ###

.gitignore

@@ -33,3 +33,5 @@ build
 ###> phpstan/phpstan ###
 phpstan.neon
 ###< phpstan/phpstan ###
+
+/deploy-instruction.md

compose.override.yaml

@@ -30,5 +30,5 @@ services:
 ###> doctrine/doctrine-bundle ###
   database:
     ports:
-      - "5432"
+      - "5432:5432"
 ###< doctrine/doctrine-bundle ###

composer.lock

@@ -0,0 +1,20 @@
+mcp:
+    app: 'killer-party-app' # Application name to be exposed to clients
+    version: '1.0.0' # Application version to be exposed to clients
+    pagination_limit: 50 # Maximum number of items returned per list request (default: 50)
+    instructions: | # Instructions describing server purpose and usage context (for LLMs)
+        This server provides information about the Killer Party game data.
+
+        Use when being ask about game data like players, rooms created, missions, etc.
+        This server provides stats and figures about the game.
+    client_transports:
+        stdio: true
+        http: true # Enable HTTP transport via controller
+
+    # HTTP transport configuration (optional)
+    http:
+        path: /_mcp # HTTP endpoint path (default: /_mcp)
+        session:
+            store: file # Session store type: 'file' or 'memory' (default: file)
+            directory: '%kernel.cache_dir%/mcp-sessions' # Directory for file store (default: cache_dir/mcp-sessions)
+            ttl: 3600 # Session TTL in seconds (default: 3600)

config/packages/mcp.yaml

@@ -1,3 +1,7 @@
 controllers:
     resource: ../src/Api/Controller/
     type: attribute
+
+_mcp:
+    resource: .
+    type: mcp

config/routes.yaml

@@ -215,6 +215,12 @@ public function killTarget(Player $player): JsonResponse
 
         $this->persistenceAdapter->flush();
 
+        $playerTarget = $player->getTarget();
+        $this->hub->publish(
+            sprintf('player/%s', $playerTarget?->getId()),
+            $this->serializer->serialize((object) $playerTarget, [AbstractNormalizer::GROUPS => 'publish-mercure']),
+        );
+
         return $this->json(null, Response::HTTP_OK);
     }
 }

src/Api/Controller/PlayerController.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\UseCase\Room;
+
+use App\Domain\Player\Enum\PlayerStatus;
+use App\Domain\Room\Entity\Room;
+use App\Domain\Room\RoomRepository;
+
+final readonly class RoomReportUseCase
+{
+    public function __construct(private RoomRepository $roomRepository)
+    {
+    }
+
+    /**
+     * Generate a comprehensive report for a room.
+     *
+     * @return array{
+     *     roomId: string,
+     *     roomName: string,
+     *     status: string,
+     *     isInGame: bool,
+     *     totalPlayers: int,
+     *     alivePlayers: int,
+     *     totalMissions: int,
+     *     createdAt: string|null,
+     *     dateEnd: string|null,
+     *     isGameMastered: bool,
+     *     hasWinner: bool,
+     *     winnerName: string|null
+     * }|array{error: string, roomId: string}
+     */
+    public function execute(string $roomId): array
+    {
+        $room = $this->roomRepository->find($roomId);
+
+        if (!$room instanceof Room) {
+            return [
+                'error' => 'Room not found',
+                'roomId' => $roomId,
+            ];
+        }
+
+        $players = $room->getPlayers();
+        $alivePlayers = array_filter(
+            $players->toArray(),
+            static fn ($player) => $player->getStatus() === PlayerStatus::ALIVE,
+        );
+
+        return [
+            'roomId' => $room->getId(),
+            'roomName' => $room->getName(),
+            'status' => $room->getStatus(),
+            'isInGame' => $room->getStatus() === Room::IN_GAME,
+            'totalPlayers' => $players->count(),
+            'alivePlayers' => count($alivePlayers),
+            'totalMissions' => $room->getMissions()->count(),
+            'createdAt' => $room->getCreatedAt()?->format('Y-m-d H:i:s'),
+            'dateEnd' => $room->getDateEnd()?->format('Y-m-d H:i:s'),
+            'isGameMastered' => $room->isGameMastered(),
+            'hasWinner' => $room->getWinner() !== null,
+            'winnerName' => $room->getWinner()?->getName(),
+        ];
+    }
+}

src/Application/UseCase/Room/RoomReportUseCase.php

@@ -10,8 +10,6 @@
 /** @extends BaseRepository<Room> */
 interface RoomRepository extends BaseRepository
 {
-    public function getRoomByIdOrCode(mixed $identifier): mixed;
-
     public function getEmptyRooms(): iterable;
 
     public function countInGameRooms(): int;

src/Domain/Room/RoomRepository.php

@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Infrastructure\Mcp\Prompts;
+
+use Mcp\Capability\Attribute\McpPrompt;
+
+#[McpPrompt(
+    name: 'room_report',
+    description: 'Generate a comprehensive and nicely formatted report about a game room',
+)]
+readonly class ReportPrompt
+{
+    /**
+     * Generate a prompt to build a room report.
+     *
+     * @param string $roomId The ID or code of the room to report on
+     */
+    public function __invoke(string $roomId): array
+    {
+        return [
+            'role' => 'user',
+            // phpcs:ignore Squiz.Arrays.ArrayDeclaration.NoComma
+            'content' => <<<PROMPT
+You are tasked with generating a comprehensive report about a game room in the Killer game application.
+
+**Instructions:**
+
+1. Use the `room_report` tool with the room ID: {$roomId}
+2. The tool will return the following information:
+   - Room ID and name
+   - Game status (IN_GAME, PENDING, or ENDED)
+   - Total number of players
+   - Number of alive players
+   - Total number of missions
+   - Creation date and end date
+   - Whether the game is game-mastered
+   - Winner information (if any)
+
+3. Present the information in a clear, well-formatted manner following this structure:
+
+**Room Report Format:**
+
+```
+# Game Room Report: [Room Name]
+
+## General Information
+- **Room ID:** [ID]
+- **Room Name:** [Name]
+- **Created:** [Date]
+- **End Date:** [Date]
+- **Game Master Mode:** [Yes/No]
+
+## Game Status
+- **Status:** [IN_GAME/PENDING/ENDED]
+- **Is Currently Playing:** [Yes/No]
+
+## Players Overview
+- **Total Players:** [X]
+- **Alive Players:** [X]
+- **Eliminated Players:** [X]
+
+## Missions
+- **Total Missions:** [X]
+
+## Game Outcome
+- **Winner:** [Player name or "No winner yet"]
+```
+
+4. Add contextual insights such as:
+   - If the game is IN_GAME, mention the current state of competition
+   - If many players have been eliminated, note the intensity of the game
+   - If the game hasn't started (PENDING), mention it's waiting to begin
+   - If the game has ENDED, highlight the winner
+
+5. Use clear formatting with headers, bullet points, and emphasis where appropriate
+
+**Now generate the report for room: {$roomId}**
+PROMPT,
+        ];
+    }
+}