MCP

Laravel Copilot SDK의 세션 설정과 Server RPC API로 MCP 서버를 구성, 관리하는 방법을 설명합니다.

​

MCP

SessionConfig의 mcpServers에 MCP 서버를 지정하면 사용할 수 있습니다.

Copilot CLI에서 Laravel Boost를 사용하는 경우 laravel-boost-copilot-cli도 함께 사용해 주세요. 'type' => 'stdio'(또는 'local')와 'tools' => ['*']가 필수라는 것이 확인되었습니다. 이것이 없으면 MCP 서버로 인식되지 않습니다.

Artisan::command('copilot:mcp', function () {
    $config = new SessionConfig(
        mcpServers: [
            'laravel-boost' => [
                'type' => 'stdio',
                'command' => 'php',
                'args' => ['artisan', 'boost:mcp'],
                'tools' => ['*'],
            ],
        ],
    );

    Copilot::start(function (CopilotSession $session) {
        info('Starting Copilot with Laravel Boost MCP: '.$session->id());

        $prompt = '어떤 MCP가 로드되어 있어? laravel-boost를 사용할 수 있다면 application-info로 앱 정보를 가져와줘.';

        warning($prompt);

        $response = spin(
            callback: fn () => $session->sendAndWait($prompt),
            message: 'Thinking...',
        );

        note($response->content());
    }, config: $config);
});

​

MCP 서버의 상태

세션 내 MCP 서버의 상태는 다음 값을 가집니다.

상태	설명
connected	접속됨
failed	접속 실패
needs-auth	인증이 필요
pending	접속 대기
disabled	비활성화됨
not_configured	미설정

​

MCP 서버 설정 관리(Server RPC)

세션과 별개로, 서버 레벨에서 MCP 서버의 설정을 관리할 수 있습니다.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\McpConfigAddRequest;
use Revolution\Copilot\Types\Rpc\McpConfigUpdateRequest;
use Revolution\Copilot\Types\Rpc\McpConfigRemoveRequest;
use Revolution\Copilot\Types\Rpc\McpServerValue;

// 설정된 MCP 서버 목록 가져오기
$result = Copilot::client()->rpc()->mcp()->list();
foreach ($result->servers as $name => $config) {
    dump($name, $config->type, $config->command);
}

// MCP 서버 추가
Copilot::client()->rpc()->mcp()->add(new McpConfigAddRequest(
    name: 'laravel-boost',
    config: new McpServerValue(
        type: 'stdio',
        command: 'php',
        args: ['artisan', 'boost:mcp'],
        tools: ['*'],
    ),
));

// MCP 서버 설정 업데이트
Copilot::client()->rpc()->mcp()->update(new McpConfigUpdateRequest(
    name: 'laravel-boost',
    config: new McpServerValue(
        type: 'stdio',
        command: 'php',
        args: ['artisan', 'boost:mcp', '--verbose'],
        tools: ['*'],
    ),
));

// MCP 서버 삭제
Copilot::client()->rpc()->mcp()->remove(new McpConfigRemoveRequest(name: 'laravel-boost'));

최신 정보는 GitHub 저장소를 참고하세요.