feat(mcp) : add CRUD tools for Sites, Constructeurs, Products

- 5 tools each: list, get, create, update, delete
- McpToolHelper extracted to AbstractApiTestCase for reuse
- DashboardStatsToolTest simplified to use base helpers
- 22 MCP tests pass

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Matthieu
2026-03-16 14:31:15 +01:00
parent e335f4c24c
commit 4f1e136dc5
20 changed files with 1184 additions and 90 deletions

View File

@@ -0,0 +1,54 @@
<?php
declare(strict_types=1);
namespace App\Mcp\Tool\Site;
use App\Entity\Site;
use App\Mcp\Tool\McpToolHelper;
use Doctrine\ORM\EntityManagerInterface;
use Mcp\Capability\Attribute\McpTool;
use Symfony\Bundle\SecurityBundle\Security;
#[McpTool(
name: 'create_site',
description: 'Create a new industrial site. Requires ROLE_GESTIONNAIRE.',
)]
class CreateSiteTool
{
use McpToolHelper;
public function __construct(
private readonly EntityManagerInterface $em,
private readonly Security $security,
) {}
public function __invoke(
string $name,
string $contactName = '',
string $contactPhone = '',
string $contactAddress = '',
string $contactPostalCode = '',
string $contactCity = '',
string $color = '',
): array {
$this->requireRole($this->security, 'ROLE_GESTIONNAIRE');
$site = new Site();
$site->setName($name);
$site->setContactName($contactName);
$site->setContactPhone($contactPhone);
$site->setContactAddress($contactAddress);
$site->setContactPostalCode($contactPostalCode);
$site->setContactCity($contactCity);
$site->setColor($color);
$this->em->persist($site);
$this->em->flush();
return $this->jsonResponse([
'id' => $site->getId(),
'name' => $site->getName(),
]);
}
}

View File

@@ -0,0 +1,42 @@
<?php
declare(strict_types=1);
namespace App\Mcp\Tool\Site;
use App\Mcp\Tool\McpToolHelper;
use App\Repository\SiteRepository;
use Doctrine\ORM\EntityManagerInterface;
use Mcp\Capability\Attribute\McpTool;
use Symfony\Bundle\SecurityBundle\Security;
#[McpTool(
name: 'delete_site',
description: 'Delete a site by ID. Requires ROLE_GESTIONNAIRE.',
)]
class DeleteSiteTool
{
use McpToolHelper;
public function __construct(
private readonly SiteRepository $sites,
private readonly EntityManagerInterface $em,
private readonly Security $security,
) {}
public function __invoke(string $siteId): array
{
$this->requireRole($this->security, 'ROLE_GESTIONNAIRE');
$site = $this->sites->find($siteId);
if (!$site) {
$this->mcpError('not_found', "Site not found: {$siteId}");
}
$this->em->remove($site);
$this->em->flush();
return $this->jsonResponse(['deleted' => true, 'id' => $siteId]);
}
}

View File

@@ -0,0 +1,44 @@
<?php
declare(strict_types=1);
namespace App\Mcp\Tool\Site;
use App\Mcp\Tool\McpToolHelper;
use App\Repository\SiteRepository;
use Mcp\Capability\Attribute\McpTool;
#[McpTool(
name: 'get_site',
description: 'Get a single site by ID with all its details (name, contact info, address).',
)]
class GetSiteTool
{
use McpToolHelper;
public function __construct(
private readonly SiteRepository $sites,
) {}
public function __invoke(string $siteId): array
{
$site = $this->sites->find($siteId);
if (!$site) {
$this->mcpError('not_found', "Site not found: {$siteId}");
}
return $this->jsonResponse([
'id' => $site->getId(),
'name' => $site->getName(),
'contactName' => $site->getContactName(),
'contactPhone' => $site->getContactPhone(),
'contactAddress' => $site->getContactAddress(),
'contactPostalCode' => $site->getContactPostalCode(),
'contactCity' => $site->getContactCity(),
'color' => $site->getColor(),
'createdAt' => $site->getCreatedAt()->format('Y-m-d H:i:s'),
'updatedAt' => $site->getUpdatedAt()->format('Y-m-d H:i:s'),
]);
}
}

View File

@@ -0,0 +1,55 @@
<?php
declare(strict_types=1);
namespace App\Mcp\Tool\Site;
use App\Mcp\Tool\McpToolHelper;
use App\Repository\SiteRepository;
use Mcp\Capability\Attribute\McpTool;
#[McpTool(
name: 'list_sites',
description: 'List all industrial sites with pagination. Sites contain machines. Filterable by name.',
)]
class ListSitesTool
{
use McpToolHelper;
public function __construct(
private readonly SiteRepository $sites,
) {}
public function __invoke(int $page = 1, int $limit = 30, string $search = ''): array
{
$p = $this->paginationParams($page, $limit);
$countQb = $this->sites->createQueryBuilder('s')
->select('COUNT(s.id)')
;
$qb = $this->sites->createQueryBuilder('s')
->select('s.id', 's.name', 's.contactName', 's.contactCity', 's.contactPhone')
->orderBy('s.name', 'ASC')
;
if ('' !== $search) {
$countQb->andWhere('LOWER(s.name) LIKE LOWER(:search)')
->setParameter('search', "%{$search}%")
;
$qb->andWhere('LOWER(s.name) LIKE LOWER(:search)')
->setParameter('search', "%{$search}%")
;
}
$total = (int) $countQb->getQuery()->getSingleScalarResult();
$items = $qb->setFirstResult($p['offset'])
->setMaxResults($p['limit'])
->getQuery()
->getArrayResult()
;
return $this->paginatedResponse($items, $total, $p['page'], $p['limit']);
}
}

View File

@@ -0,0 +1,71 @@
<?php
declare(strict_types=1);
namespace App\Mcp\Tool\Site;
use App\Mcp\Tool\McpToolHelper;
use App\Repository\SiteRepository;
use Doctrine\ORM\EntityManagerInterface;
use Mcp\Capability\Attribute\McpTool;
use Symfony\Bundle\SecurityBundle\Security;
#[McpTool(
name: 'update_site',
description: 'Update an existing site. Only provided fields are changed. Requires ROLE_GESTIONNAIRE.',
)]
class UpdateSiteTool
{
use McpToolHelper;
public function __construct(
private readonly SiteRepository $sites,
private readonly EntityManagerInterface $em,
private readonly Security $security,
) {}
public function __invoke(
string $siteId,
?string $name = null,
?string $contactName = null,
?string $contactPhone = null,
?string $contactAddress = null,
?string $contactPostalCode = null,
?string $contactCity = null,
?string $color = null,
): array {
$this->requireRole($this->security, 'ROLE_GESTIONNAIRE');
$site = $this->sites->find($siteId);
if (!$site) {
$this->mcpError('not_found', "Site not found: {$siteId}");
}
if (null !== $name) {
$site->setName($name);
}
if (null !== $contactName) {
$site->setContactName($contactName);
}
if (null !== $contactPhone) {
$site->setContactPhone($contactPhone);
}
if (null !== $contactAddress) {
$site->setContactAddress($contactAddress);
}
if (null !== $contactPostalCode) {
$site->setContactPostalCode($contactPostalCode);
}
if (null !== $contactCity) {
$site->setContactCity($contactCity);
}
if (null !== $color) {
$site->setColor($color);
}
$this->em->flush();
return $this->jsonResponse(['id' => $site->getId(), 'name' => $site->getName()]);
}
}