PetschStudios/KanbanGit
3
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases 27 Wiki Activity

Add KanbanGit MCP v0.1

Browse Source
This commit is contained in:
Twyco
2026-04-20 20:36:59 +02:00
parent bf0e50464a
commit cd574ec26b
15 changed files with 1289 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/Mcp/Tools/GetTicket.php
+50
View File
@@ -0,0 +1,50 @@
<?php
namespace App\Mcp\Tools;
use App\Mcp\Support\KanbanGitMcp;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
#[Name('get_ticket')]
#[Description('Get a visible ticket with project, status, type, priority, assignee, author, field values, and worklog data.')]
#[IsReadOnly]
class GetTicket extends Tool
{
public function __construct(
private readonly KanbanGitMcp $kanbanGitMcp,
) {}
public function handle(Request $request): Response|ResponseFactory
{
$validated = $request->validate([
'ticket_id' => ['required', 'integer'],
]);
$user = $this->kanbanGitMcp->user($request);
$ticket = $this->kanbanGitMcp->ticketForRead($user, (int) $validated['ticket_id']);
return Response::structured([
'data' => $this->kanbanGitMcp->ticketPayload($ticket),
]);
}
/**
* @return array<string, Type>
*/
public function schema(JsonSchema $schema): array
{
return [
'ticket_id' => $schema->integer()
->description('Ticket ID.')
->required(),
];
}
}
app/Mcp/Tools/ListMyAssignedTickets.php
+56
View File
@@ -0,0 +1,56 @@
<?php
namespace App\Mcp\Tools;
use App\Actions\Tickets\ListAssignedTicketsByVisibleProject;
use App\Http\Resources\UserResource;
use App\Mcp\Support\KanbanGitMcp;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
#[Name('list_my_assigned_tickets')]
#[Description('List tickets assigned to the authenticated application key owner, grouped by visible project. Optionally filter to one project.')]
#[IsReadOnly]
class ListMyAssignedTickets extends Tool
{
public function __construct(
private readonly KanbanGitMcp $kanbanGitMcp,
private readonly ListAssignedTicketsByVisibleProject $listAssignedTicketsByVisibleProject,
) {}
public function handle(Request $request): Response|ResponseFactory
{
$validated = $request->validate([
'project_id' => ['nullable', 'integer'],
]);
$user = $this->kanbanGitMcp->user($request);
$project = $this->kanbanGitMcp->projectForRead($user, $validated['project_id'] ?? null);
return Response::structured([
'data' => $this->listAssignedTicketsByVisibleProject->handle($user, $user, $project),
'meta' => [
'assignee' => UserResource::make($user)->resolve(),
],
]);
}
/**
* @return array<string, Type>
*/
public function schema(JsonSchema $schema): array
{
return [
'project_id' => $schema->integer()
->nullable()
->description('Optional project ID. When omitted, tickets from all visible projects are returned.'),
];
}
}
app/Mcp/Tools/ListTicketsByStatus.php
+73
View File
@@ -0,0 +1,73 @@
<?php
namespace App\Mcp\Tools;
use App\Actions\Tickets\ListTicketsByStatusByVisibleProject;
use App\Http\Resources\TicketStatusResource;
use App\Mcp\Support\KanbanGitMcp;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
#[Name('list_tickets_by_status')]
#[Description('List tickets in a status, grouped by visible project. Use ticket_status_id when possible; status_slug or status_name are convenience lookups and must be unambiguous.')]
#[IsReadOnly]
class ListTicketsByStatus extends Tool
{
public function __construct(
private readonly KanbanGitMcp $kanbanGitMcp,
private readonly ListTicketsByStatusByVisibleProject $listTicketsByStatusByVisibleProject,
) {}
public function handle(Request $request): Response|ResponseFactory
{
$validated = $request->validate([
'project_id' => ['nullable', 'integer'],
'status_name' => ['nullable', 'string'],
'status_slug' => ['nullable', 'string'],
'ticket_status_id' => ['nullable', 'integer'],
]);
$user = $this->kanbanGitMcp->user($request);
$project = $this->kanbanGitMcp->projectForRead($user, $validated['project_id'] ?? null);
$ticketStatuses = $this->kanbanGitMcp->resolveTicketStatuses($user, $validated, $project);
if ($ticketStatuses instanceof Response) {
return $ticketStatuses;
}
return Response::structured([
'data' => $this->listTicketsByStatusByVisibleProject->handle($user, $ticketStatuses, $project),
'meta' => [
'statuses' => TicketStatusResource::collection($ticketStatuses)->resolve(),
],
]);
}
/**
* @return array<string, Type>
*/
public function schema(JsonSchema $schema): array
{
return [
'project_id' => $schema->integer()
->nullable()
->description('Optional project ID. Use it to scope status_name or status_slug and avoid ambiguity.'),
'status_name' => $schema->string()
->nullable()
->description('Exact ticket status name. Must match exactly and be unambiguous.'),
'status_slug' => $schema->string()
->nullable()
->description('Ticket status slug. Must be unambiguous unless project_id is provided.'),
'ticket_status_id' => $schema->integer()
->nullable()
->description('Stable ticket status ID. Preferred when available.'),
];
}
}
app/Mcp/Tools/MoveTicketStatus.php
+99
View File
@@ -0,0 +1,99 @@
<?php
namespace App\Mcp\Tools;
use App\Actions\Tickets\MoveProjectTicket;
use App\Mcp\Support\KanbanGitMcp;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsDestructive;
#[Name('move_ticket_status')]
#[Description('Move a ticket to an allowed target status. Use ticket_status_id when possible; status_slug or status_name are convenience lookups and must resolve to one status in the ticket project.')]
#[IsDestructive(false)]
class MoveTicketStatus extends Tool
{
public function __construct(
private readonly KanbanGitMcp $kanbanGitMcp,
private readonly MoveProjectTicket $moveProjectTicket,
) {}
public function handle(Request $request): Response|ResponseFactory
{
$validated = $request->validate([
'status_name' => ['nullable', 'string'],
'status_slug' => ['nullable', 'string'],
'ticket_id' => ['required', 'integer'],
'ticket_status_id' => ['nullable', 'integer'],
]);
$user = $this->kanbanGitMcp->user($request);
$ticket = $this->kanbanGitMcp->ticketForWrite($user, (int) $validated['ticket_id']);
$ticketStatuses = $this->kanbanGitMcp->resolveTicketStatuses($user, $validated, $ticket->project);
if ($ticketStatuses instanceof Response) {
return $ticketStatuses;
}
if ($ticketStatuses->isEmpty()) {
return Response::error('Ticket status was not found in this ticket project.');
}
$destinationStatus = $ticketStatuses->first();
if ($destinationStatus->project_id !== $ticket->project_id) {
return Response::error('Ticket status must belong to the same project as the ticket.');
}
$ticket->loadMissing('ticketStatus');
if (
$ticket->ticket_status_id !== $destinationStatus->id
&& ! ($ticket->ticketStatus?->allowedTargetStatuses()->whereKey($destinationStatus->id)->exists() ?? false)
) {
return Response::error('Choose a status this ticket is allowed to move to.');
}
$result = $this->moveProjectTicket->handle($ticket->project, $ticket, $user, [
'ticket_status_id' => $destinationStatus->id,
]);
return Response::structured([
'data' => $this->kanbanGitMcp->ticketPayload($ticket->fresh()),
'meta' => [
'destination_label' => $result['destination_label'],
'message' => $result['moved']
? "{$ticket->ticket_key} moved to {$result['destination_label']}."
: "{$ticket->ticket_key} already belongs to {$result['destination_label']}.",
'moved' => $result['moved'],
],
]);
}
/**
* @return array<string, Type>
*/
public function schema(JsonSchema $schema): array
{
return [
'status_name' => $schema->string()
->nullable()
->description('Exact target status name. Must resolve to one status in the ticket project.'),
'status_slug' => $schema->string()
->nullable()
->description('Target status slug. Must resolve to one status in the ticket project.'),
'ticket_id' => $schema->integer()
->description('Ticket ID.')
->required(),
'ticket_status_id' => $schema->integer()
->nullable()
->description('Stable target status ID. Preferred when available.'),
];
}
}
app/Mcp/Tools/UpdateTicketAssignee.php
+68
View File
@@ -0,0 +1,68 @@
<?php
namespace App\Mcp\Tools;
use App\Actions\Tickets\UpdateProjectTicket;
use App\Mcp\Support\KanbanGitMcp;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsDestructive;
#[Name('update_ticket_assignee')]
#[Description('Assign or unassign a ticket while preserving all other ticket fields. Requires project write permission.')]
#[IsDestructive(false)]
class UpdateTicketAssignee extends Tool
{
public function __construct(
private readonly KanbanGitMcp $kanbanGitMcp,
private readonly UpdateProjectTicket $updateProjectTicket,
) {}
public function handle(Request $request): Response|ResponseFactory
{
$validated = $request->validate([
'assignee_user_id' => ['present', 'nullable', 'integer', 'exists:users,id'],
'ticket_id' => ['required', 'integer'],
]);
$user = $this->kanbanGitMcp->user($request);
$ticket = $this->kanbanGitMcp->ticketForWrite($user, (int) $validated['ticket_id']);
$payload = [
...$this->kanbanGitMcp->updatePayload($ticket),
'assignee_user_id' => $validated['assignee_user_id'] ?? null,
];
$wasUpdated = $this->updateProjectTicket->handle($ticket, $user, $payload);
return Response::structured([
'data' => $this->kanbanGitMcp->ticketPayload($ticket->fresh()),
'meta' => [
'message' => $wasUpdated
? "{$ticket->ticket_key} assignee was updated."
: 'No ticket changes were detected.',
],
]);
}
/**
* @return array<string, Type>
*/
public function schema(JsonSchema $schema): array
{
return [
'assignee_user_id' => $schema->integer()
->nullable()
->description('User ID to assign. Pass null to unassign.')
->required(),
'ticket_id' => $schema->integer()
->description('Ticket ID.')
->required(),
];
}
}
app/Mcp/Tools/UpdateTicketDescription.php
+67
View File
@@ -0,0 +1,67 @@
<?php
namespace App\Mcp\Tools;
use App\Actions\Tickets\UpdateProjectTicket;
use App\Mcp\Support\KanbanGitMcp;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsDestructive;
#[Name('update_ticket_description')]
#[Description('Update only a ticket description while preserving all other ticket fields. Requires project write permission.')]
#[IsDestructive(false)]
class UpdateTicketDescription extends Tool
{
public function __construct(
private readonly KanbanGitMcp $kanbanGitMcp,
private readonly UpdateProjectTicket $updateProjectTicket,
) {}
public function handle(Request $request): Response|ResponseFactory
{
$validated = $request->validate([
'description' => ['nullable', 'string'],
'ticket_id' => ['required', 'integer'],
]);
$user = $this->kanbanGitMcp->user($request);
$ticket = $this->kanbanGitMcp->ticketForWrite($user, (int) $validated['ticket_id']);
$payload = [
...$this->kanbanGitMcp->updatePayload($ticket),
'description' => $validated['description'] ?? null,
];
$wasUpdated = $this->updateProjectTicket->handle($ticket, $user, $payload);
return Response::structured([
'data' => $this->kanbanGitMcp->ticketPayload($ticket->fresh()),
'meta' => [
'message' => $wasUpdated
? "{$ticket->ticket_key} description was updated."
: 'No ticket changes were detected.',
],
]);
}
/**
* @return array<string, Type>
*/
public function schema(JsonSchema $schema): array
{
return [
'description' => $schema->string()
->nullable()
->description('New ticket description. Pass null to clear it.'),
'ticket_id' => $schema->integer()
->description('Ticket ID.')
->required(),
];
}
}