92 lines
2.7 KiB
PHP
92 lines
2.7 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the official PHP MCP SDK.
|
|
*
|
|
* A collaboration between Symfony and the PHP Foundation.
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Mcp\Example\CustomDependencies;
|
|
|
|
use Mcp\Capability\Attribute\McpResource;
|
|
use Mcp\Capability\Attribute\McpTool;
|
|
use Mcp\Example\CustomDependencies\Service\StatsServiceInterface;
|
|
use Mcp\Example\CustomDependencies\Service\TaskRepositoryInterface;
|
|
use Psr\Log\LoggerInterface;
|
|
|
|
/**
|
|
* @phpstan-import-type Task from TaskRepositoryInterface
|
|
*/
|
|
final class McpTaskHandlers
|
|
{
|
|
public function __construct(
|
|
private readonly TaskRepositoryInterface $taskRepo,
|
|
private readonly StatsServiceInterface $statsService,
|
|
private readonly LoggerInterface $logger,
|
|
) {
|
|
$this->logger->info('McpTaskHandlers instantiated with dependencies.');
|
|
}
|
|
|
|
/**
|
|
* Adds a new task for a given user.
|
|
*
|
|
* @param string $userId the ID of the user
|
|
* @param string $description the task description
|
|
*
|
|
* @return Task the created task details
|
|
*/
|
|
#[McpTool(name: 'add_task')]
|
|
public function addTask(string $userId, string $description): array
|
|
{
|
|
$this->logger->info("Tool 'add_task' invoked", ['userId' => $userId]);
|
|
|
|
return $this->taskRepo->addTask($userId, $description);
|
|
}
|
|
|
|
/**
|
|
* Lists pending tasks for a specific user.
|
|
*
|
|
* @param string $userId the ID of the user
|
|
*
|
|
* @return Task[] a list of tasks
|
|
*/
|
|
#[McpTool(name: 'list_user_tasks')]
|
|
public function listUserTasks(string $userId): array
|
|
{
|
|
$this->logger->info("Tool 'list_user_tasks' invoked", ['userId' => $userId]);
|
|
|
|
return $this->taskRepo->getTasksForUser($userId);
|
|
}
|
|
|
|
/**
|
|
* Marks a task as complete.
|
|
*
|
|
* @param int $taskId the ID of the task to complete
|
|
*
|
|
* @return array<string, mixed> status of the operation
|
|
*/
|
|
#[McpTool(name: 'complete_task')]
|
|
public function completeTask(int $taskId): array
|
|
{
|
|
$this->logger->info("Tool 'complete_task' invoked", ['taskId' => $taskId]);
|
|
$success = $this->taskRepo->completeTask($taskId);
|
|
|
|
return ['success' => $success, 'message' => $success ? "Task {$taskId} completed." : "Task {$taskId} not found."];
|
|
}
|
|
|
|
/**
|
|
* Provides current system statistics.
|
|
*
|
|
* @return array<string, int> system statistics
|
|
*/
|
|
#[McpResource(uri: 'stats://system/overview', name: 'system_stats', mimeType: 'application/json')]
|
|
public function getSystemStatistics(): array
|
|
{
|
|
$this->logger->info("Resource 'stats://system/overview' invoked");
|
|
|
|
return $this->statsService->getSystemStats();
|
|
}
|
|
}
|