feat : add 22 MCP tool classes for projects, tasks, and time tracking

Tools: list-users, list-clients, list/get/create/update-project, list/get/create/update/delete-task, list-statuses/priorities/efforts/tags, list/create/update-group, list/create/update/delete-time-entry. Attribute moved to class level for SDK discovery compatibility. Install nyholm/psr7 for HTTP transport PSR-17 support. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 19:45:39 +01:00
parent 68dd9599a9
commit 3d1a510d82
24 changed files with 1527 additions and 1 deletions
@@ -0,0 +1,121 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mcp\Tool\TimeEntry;
+
+use App\Entity\TimeEntry;
+use App\Repository\ProjectRepository;
+use App\Repository\TaskRepository;
+use App\Repository\TaskTagRepository;
+use App\Repository\TimeEntryRepository;
+use App\Repository\UserRepository;
+use DateTimeImmutable;
+use Doctrine\ORM\EntityManagerInterface;
+use InvalidArgumentException;
+use Mcp\Capability\Attribute\McpTool;
+
+use function sprintf;
+
+#[McpTool(name: 'create-time-entry', description: 'Create a time entry. If stoppedAt is null, creates an active timer. Only one active timer per user is allowed.')]
+class CreateTimeEntryTool
+{
+    public function __construct(
+        private readonly EntityManagerInterface $entityManager,
+        private readonly UserRepository $userRepository,
+        private readonly ProjectRepository $projectRepository,
+        private readonly TaskRepository $taskRepository,
+        private readonly TaskTagRepository $taskTagRepository,
+        private readonly TimeEntryRepository $timeEntryRepository,
+    ) {}
+
+    public function __invoke(
+        int $userId,
+        string $startedAt,
+        ?string $title = null,
+        ?string $stoppedAt = null,
+        ?int $projectId = null,
+        ?int $taskId = null,
+        ?array $tagIds = null,
+        ?string $description = null,
+    ): string {
+        $user = $this->userRepository->find($userId);
+        if (null === $user) {
+            throw new InvalidArgumentException(sprintf('User with ID %d not found.', $userId));
+        }
+
+        // Check for existing active timer if creating a new active one
+        if (null === $stoppedAt) {
+            $activeEntry = $this->timeEntryRepository->findActiveByUser($user);
+            if (null !== $activeEntry) {
+                throw new InvalidArgumentException(sprintf('User "%s" already has an active timer (ID %d). Stop it before starting a new one.', $user->getUsername(), $activeEntry->getId()));
+            }
+        }
+
+        $entry = new TimeEntry();
+        $entry->setUser($user);
+        $entry->setStartedAt(new DateTimeImmutable($startedAt));
+
+        if (null !== $title) {
+            $entry->setTitle($title);
+        }
+        if (null !== $stoppedAt) {
+            $entry->setStoppedAt(new DateTimeImmutable($stoppedAt));
+        }
+        if (null !== $description) {
+            $entry->setDescription($description);
+        }
+        if (null !== $projectId) {
+            $project = $this->projectRepository->find($projectId);
+            if (null === $project) {
+                throw new InvalidArgumentException(sprintf('Project with ID %d not found.', $projectId));
+            }
+            $entry->setProject($project);
+        }
+        if (null !== $taskId) {
+            $task = $this->taskRepository->find($taskId);
+            if (null === $task) {
+                throw new InvalidArgumentException(sprintf('Task with ID %d not found.', $taskId));
+            }
+            $entry->setTask($task);
+        }
+        if (null !== $tagIds) {
+            foreach ($tagIds as $tagId) {
+                $tag = $this->taskTagRepository->find($tagId);
+                if (null === $tag) {
+                    throw new InvalidArgumentException(sprintf('TaskTag with ID %d not found.', $tagId));
+                }
+                $entry->addTag($tag);
+            }
+        }
+
+        $this->entityManager->persist($entry);
+        $this->entityManager->flush();
+
+        return json_encode([
+            'id'          => $entry->getId(),
+            'title'       => $entry->getTitle(),
+            'description' => $entry->getDescription(),
+            'startedAt'   => $entry->getStartedAt()?->format('c'),
+            'stoppedAt'   => $entry->getStoppedAt()?->format('c'),
+            'duration'    => $entry->getStoppedAt() && $entry->getStartedAt()
+                ? (int) round(($entry->getStoppedAt()->getTimestamp() - $entry->getStartedAt()->getTimestamp()) / 60)
+                : null,
+            'user'    => ['id' => $user->getId(), 'username' => $user->getUsername()],
+            'project' => $entry->getProject() ? [
+                'id'   => $entry->getProject()->getId(),
+                'code' => $entry->getProject()->getCode(),
+                'name' => $entry->getProject()->getName(),
+            ] : null,
+            'task' => $entry->getTask() ? [
+                'id'     => $entry->getTask()->getId(),
+                'number' => $entry->getTask()->getNumber(),
+                'title'  => $entry->getTask()->getTitle(),
+            ] : null,
+            'tags' => $entry->getTags()->map(fn ($t) => [
+                'id'    => $t->getId(),
+                'label' => $t->getLabel(),
+            ])->toArray(),
+        ]);
+    }
+}
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mcp\Tool\TimeEntry;
+
+use App\Repository\TimeEntryRepository;
+use Doctrine\ORM\EntityManagerInterface;
+use InvalidArgumentException;
+use Mcp\Capability\Attribute\McpTool;
+
+use function sprintf;
+
+#[McpTool(name: 'delete-time-entry', description: 'Delete a time entry permanently')]
+class DeleteTimeEntryTool
+{
+    public function __construct(
+        private readonly TimeEntryRepository $timeEntryRepository,
+        private readonly EntityManagerInterface $entityManager,
+    ) {}
+
+    public function __invoke(int $id): string
+    {
+        $entry = $this->timeEntryRepository->find($id);
+
+        if (null === $entry) {
+            throw new InvalidArgumentException(sprintf('TimeEntry with ID %d not found.', $id));
+        }
+
+        $this->entityManager->remove($entry);
+        $this->entityManager->flush();
+
+        return json_encode([
+            'success' => true,
+            'message' => 'Time entry deleted.',
+        ]);
+    }
+}
@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mcp\Tool\TimeEntry;
+
+use App\Repository\TimeEntryRepository;
+use DateTimeImmutable;
+use Mcp\Capability\Attribute\McpTool;
+
+#[McpTool(name: 'list-time-entries', description: 'List time entries with optional filters. Duration is computed in minutes and null for active timers.')]
+class ListTimeEntriesTool
+{
+    public function __construct(
+        private readonly TimeEntryRepository $timeEntryRepository,
+    ) {}
+
+    public function __invoke(
+        ?int $userId = null,
+        ?int $projectId = null,
+        ?int $taskId = null,
+        ?string $startDate = null,
+        ?string $endDate = null,
+        int $limit = 100,
+    ): string {
+        $limit = min($limit, 200);
+
+        $qb = $this->timeEntryRepository->createQueryBuilder('te')
+            ->leftJoin('te.user', 'u')->addSelect('u')
+            ->leftJoin('te.project', 'p')->addSelect('p')
+            ->leftJoin('te.task', 't')->addSelect('t')
+            ->leftJoin('te.tags', 'tg')->addSelect('tg')
+            ->orderBy('te.startedAt', 'DESC')
+            ->setMaxResults($limit)
+        ;
+
+        if (null !== $userId) {
+            $qb->andWhere('u.id = :userId')->setParameter('userId', $userId);
+        }
+        if (null !== $projectId) {
+            $qb->andWhere('p.id = :projectId')->setParameter('projectId', $projectId);
+        }
+        if (null !== $taskId) {
+            $qb->andWhere('t.id = :taskId')->setParameter('taskId', $taskId);
+        }
+        if (null !== $startDate) {
+            $qb->andWhere('te.startedAt >= :startDate')
+                ->setParameter('startDate', new DateTimeImmutable($startDate.' 00:00:00'))
+            ;
+        }
+        if (null !== $endDate) {
+            $qb->andWhere('te.startedAt <= :endDate')
+                ->setParameter('endDate', new DateTimeImmutable($endDate.' 23:59:59'))
+            ;
+        }
+
+        $entries = $qb->getQuery()->getResult();
+
+        return json_encode(array_map(fn ($entry) => [
+            'id'          => $entry->getId(),
+            'title'       => $entry->getTitle(),
+            'description' => $entry->getDescription(),
+            'startedAt'   => $entry->getStartedAt()?->format('c'),
+            'stoppedAt'   => $entry->getStoppedAt()?->format('c'),
+            'duration'    => $entry->getStoppedAt() && $entry->getStartedAt()
+                ? (int) round(($entry->getStoppedAt()->getTimestamp() - $entry->getStartedAt()->getTimestamp()) / 60)
+                : null,
+            'user' => [
+                'id'       => $entry->getUser()->getId(),
+                'username' => $entry->getUser()->getUsername(),
+            ],
+            'project' => $entry->getProject() ? [
+                'id'   => $entry->getProject()->getId(),
+                'code' => $entry->getProject()->getCode(),
+                'name' => $entry->getProject()->getName(),
+            ] : null,
+            'task' => $entry->getTask() ? [
+                'id'     => $entry->getTask()->getId(),
+                'number' => $entry->getTask()->getNumber(),
+                'title'  => $entry->getTask()->getTitle(),
+            ] : null,
+            'tags' => $entry->getTags()->map(fn ($t) => [
+                'id'    => $t->getId(),
+                'label' => $t->getLabel(),
+            ])->toArray(),
+        ], $entries));
+    }
+}
@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mcp\Tool\TimeEntry;
+
+use App\Repository\ProjectRepository;
+use App\Repository\TaskRepository;
+use App\Repository\TaskTagRepository;
+use App\Repository\TimeEntryRepository;
+use DateTimeImmutable;
+use Doctrine\ORM\EntityManagerInterface;
+use InvalidArgumentException;
+use Mcp\Capability\Attribute\McpTool;
+
+use function sprintf;
+
+#[McpTool(name: 'update-time-entry', description: 'Update a time entry. Use to stop an active timer by providing stoppedAt, or to correct start time. userId is not updatable.')]
+class UpdateTimeEntryTool
+{
+    public function __construct(
+        private readonly TimeEntryRepository $timeEntryRepository,
+        private readonly ProjectRepository $projectRepository,
+        private readonly TaskRepository $taskRepository,
+        private readonly TaskTagRepository $taskTagRepository,
+        private readonly EntityManagerInterface $entityManager,
+    ) {}
+
+    public function __invoke(
+        int $id,
+        ?string $title = null,
+        ?string $startedAt = null,
+        ?string $stoppedAt = null,
+        ?int $projectId = null,
+        ?int $taskId = null,
+        ?array $tagIds = null,
+        ?string $description = null,
+    ): string {
+        $entry = $this->timeEntryRepository->find($id);
+
+        if (null === $entry) {
+            throw new InvalidArgumentException(sprintf('TimeEntry with ID %d not found.', $id));
+        }
+
+        if (null !== $title) {
+            $entry->setTitle($title);
+        }
+        if (null !== $startedAt) {
+            $entry->setStartedAt(new DateTimeImmutable($startedAt));
+        }
+        if (null !== $stoppedAt) {
+            $entry->setStoppedAt(new DateTimeImmutable($stoppedAt));
+        }
+        if (null !== $description) {
+            $entry->setDescription($description);
+        }
+        if (null !== $projectId) {
+            $project = $this->projectRepository->find($projectId);
+            if (null === $project) {
+                throw new InvalidArgumentException(sprintf('Project with ID %d not found.', $projectId));
+            }
+            $entry->setProject($project);
+        }
+        if (null !== $taskId) {
+            $task = $this->taskRepository->find($taskId);
+            if (null === $task) {
+                throw new InvalidArgumentException(sprintf('Task with ID %d not found.', $taskId));
+            }
+            $entry->setTask($task);
+        }
+        if (null !== $tagIds) {
+            foreach ($entry->getTags()->toArray() as $existingTag) {
+                $entry->removeTag($existingTag);
+            }
+            foreach ($tagIds as $tagId) {
+                $tag = $this->taskTagRepository->find($tagId);
+                if (null === $tag) {
+                    throw new InvalidArgumentException(sprintf('TaskTag with ID %d not found.', $tagId));
+                }
+                $entry->addTag($tag);
+            }
+        }
+
+        $this->entityManager->flush();
+
+        return json_encode([
+            'id'        => $entry->getId(),
+            'title'     => $entry->getTitle(),
+            'startedAt' => $entry->getStartedAt()?->format('c'),
+            'stoppedAt' => $entry->getStoppedAt()?->format('c'),
+            'duration'  => $entry->getStoppedAt() && $entry->getStartedAt()
+                ? (int) round(($entry->getStoppedAt()->getTimestamp() - $entry->getStartedAt()->getTimestamp()) / 60)
+                : null,
+            'user'    => ['id' => $entry->getUser()->getId(), 'username' => $entry->getUser()->getUsername()],
+            'project' => $entry->getProject() ? [
+                'id'   => $entry->getProject()->getId(),
+                'code' => $entry->getProject()->getCode(),
+                'name' => $entry->getProject()->getName(),
+            ] : null,
+            'task' => $entry->getTask() ? [
+                'id'     => $entry->getTask()->getId(),
+                'number' => $entry->getTask()->getNumber(),
+                'title'  => $entry->getTask()->getTitle(),
+            ] : null,
+            'tags' => $entry->getTags()->map(fn ($t) => [
+                'id'    => $t->getId(),
+                'label' => $t->getLabel(),
+            ])->toArray(),
+        ]);
+    }
+}