Add Model Context Protocol server exposing Coolify infrastructure data to AI assistants. Includes tools for listing/fetching servers, projects, applications, databases, and services, scoped to authenticated team tokens. - Add CoolifyServer with 10 read-only tools (list/get for all resource types) - Add BuildsResponse and ResolvesTeam traits for shared tool logic - Add EnsureMcpEnabled middleware guarding /mcp routes - Add enable/disable MCP API endpoints (root-only) - Add is_mcp_server_enabled toggle in instance settings and advanced UI - Add migration for is_mcp_server_enabled column - Add feature tests for MCP endpoints and toggle API - Scrub sensitive keys (passwords, tokens, raw IDs) from all responses
50 lines
1.6 KiB
PHP
50 lines
1.6 KiB
PHP
<?php
|
|
|
|
namespace App\Mcp\Servers;
|
|
|
|
use App\Mcp\Tools\GetApplication;
|
|
use App\Mcp\Tools\GetDatabase;
|
|
use App\Mcp\Tools\GetInfrastructureOverview;
|
|
use App\Mcp\Tools\GetServer;
|
|
use App\Mcp\Tools\GetService;
|
|
use App\Mcp\Tools\ListApplications;
|
|
use App\Mcp\Tools\ListDatabases;
|
|
use App\Mcp\Tools\ListProjects;
|
|
use App\Mcp\Tools\ListServers;
|
|
use App\Mcp\Tools\ListServices;
|
|
use Laravel\Mcp\Server;
|
|
use Laravel\Mcp\Server\Attributes\Instructions;
|
|
use Laravel\Mcp\Server\Attributes\Name;
|
|
use Laravel\Mcp\Server\Attributes\Version;
|
|
|
|
#[Name('Coolify')]
|
|
#[Version('0.1.0')]
|
|
#[Instructions(<<<'MD'
|
|
Read-only MCP server for Coolify, scoped to the authenticated team token.
|
|
|
|
Recommended workflow:
|
|
1. get_infrastructure_overview — start here; single call returns all servers, projects with resource counts, and aggregates.
|
|
2. list_servers / list_projects / list_applications / list_databases / list_services — paginated summary listings (default 50 per page, cap 100).
|
|
3. get_server / get_application / get_database / get_service — full details for a single UUID.
|
|
|
|
Every response is `{ data, _actions?, _pagination? }`. `_actions` suggests the next tool + args; `_pagination.next` is the args to call again for the next page.
|
|
MD)]
|
|
class CoolifyServer extends Server
|
|
{
|
|
protected array $tools = [
|
|
GetInfrastructureOverview::class,
|
|
ListServers::class,
|
|
GetServer::class,
|
|
ListProjects::class,
|
|
ListApplications::class,
|
|
GetApplication::class,
|
|
ListDatabases::class,
|
|
GetDatabase::class,
|
|
ListServices::class,
|
|
GetService::class,
|
|
];
|
|
|
|
protected array $resources = [];
|
|
|
|
protected array $prompts = [];
|
|
}
|