Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
"mcp/sdk": "^0.8",
"psr/log": "^3.0",
"symfony/console": "^6.0 || ^7.0",
"symfony/finder": "^6.4",
"symfony/process": "^6.0 || ^7.0"
},
"license": "GPL-2.0-or-later",
Expand Down Expand Up @@ -43,6 +44,7 @@
"php": "8.1.99"
},
"allow-plugins": {
"php-http/discovery": true,
"phpstan/extension-installer": true
}
},
Expand Down
70 changes: 69 additions & 1 deletion composer.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

23 changes: 18 additions & 5 deletions src/Cli/Command/Mcp/Serve.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,14 @@
namespace mglaman\DrupalOrgCli\Command\Mcp;

use Composer\InstalledVersions;
use Mcp\Capability\Registry\Container;
use Mcp\Server;
use Mcp\Server\Transport\StdioTransport;
use mglaman\DrupalOrg\Client;
use mglaman\DrupalOrg\Mcp\ToolRegistry;
use mglaman\DrupalOrgCli\Command\Command;
use Psr\Log\AbstractLogger;
use Psr\Log\LoggerInterface;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

Expand Down Expand Up @@ -41,16 +44,26 @@ public function log($level, string|\Stringable $message, array $context = []): v
}
};

self::createServer($version, $logger)->run(new StdioTransport());

return self::SUCCESS;
}

/**
* Creates the MCP server with the tools from ToolRegistry.
*/
public static function createServer(string $version, LoggerInterface $logger, Client $client = new Client()): Server
{
$container = new Container();
$container->set(Client::class, $client);

$toolRegistryDir = dirname((string) (new \ReflectionClass(ToolRegistry::class))->getFileName());

$server = Server::builder()
return Server::builder()
->setContainer($container)
->setDiscovery($toolRegistryDir, ['.'])
->setServerInfo('Drupal.org CLI', $version)
->setLogger($logger)
->build();

$server->run(new StdioTransport());

return self::SUCCESS;
}
}
105 changes: 105 additions & 0 deletions tests/src/Command/Mcp/ServeTest.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
<?php

declare(strict_types=1);

namespace mglaman\DrupalOrg\Tests\Command\Mcp;

use GuzzleHttp\Handler\MockHandler;
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Psr7\Response;
use Mcp\Server\Transport\StdioTransport;
use mglaman\DrupalOrg\Client;
use mglaman\DrupalOrgCli\Command\Mcp\Serve;
use PHPUnit\Framework\Attributes\CoversClass;
use PHPUnit\Framework\TestCase;
use Psr\Log\NullLogger;

/**
* Drives the server that mcp:serve runs over in-memory stdio streams, with
* Drupal.org responses mocked.
*/
#[CoversClass(Serve::class)]
class ServeTest extends TestCase
{
public function testDiscoversTools(): void
{
$responses = $this->runServer(new MockHandler(), [
['jsonrpc' => '2.0', 'id' => 2, 'method' => 'tools/list'],
]);

$names = array_column($responses[2]['result']['tools'], 'name');
self::assertContains('issue_show', $names);
self::assertContains('mr_list', $names);
}

public function testCallsToolOverHttp(): void
{
$http = new MockHandler([new Response(200, [], json_encode([
'nid' => '3383637',
'type' => 'project_issue',
'title' => 'Schedule transition button size',
], JSON_THROW_ON_ERROR))]);

$responses = $this->runServer($http, [
[
'jsonrpc' => '2.0',
'id' => 2,
'method' => 'tools/call',
'params' => ['name' => 'issue_show', 'arguments' => ['nid' => '3383637']],
],
]);

self::assertArrayNotHasKey('error', $responses[2]);
self::assertSame('Schedule transition button size', $responses[2]['result']['structuredContent']['title']);
self::assertSame(0, $http->count());
}

/**
* Initializes a session, sends the given requests and returns the
* responses keyed by request ID.
*
* @param list<array<string, mixed>> $requests
*
* @return array<int, array<string, mixed>>
*/
private function runServer(MockHandler $http, array $requests): array
{
$messages = [
[
'jsonrpc' => '2.0',
'id' => 1,
'method' => 'initialize',
'params' => [
'protocolVersion' => '2025-06-18',
'capabilities' => new \stdClass(),
'clientInfo' => ['name' => 'test', 'version' => '1'],
],
],
['jsonrpc' => '2.0', 'method' => 'notifications/initialized'],
...$requests,
];
$input = fopen('php://memory', 'r+');
self::assertIsResource($input);
foreach ($messages as $message) {
fwrite($input, json_encode($message, JSON_THROW_ON_ERROR) . "\n");
}
rewind($input);
// The transport closes its output stream when the session ends, so
// write to a file that can be read back afterwards.
$outputFile = (string) tempnam(sys_get_temp_dir(), 'drupalorg-cli-mcp');
$output = fopen($outputFile, 'w');
self::assertIsResource($output);

Serve::createServer('test', new NullLogger(), new Client(false, HandlerStack::create($http)))
->run(new StdioTransport($input, $output));

$lines = (string) file_get_contents($outputFile);
unlink($outputFile);
$responses = [];
foreach (array_filter(explode("\n", $lines)) as $line) {
$response = json_decode($line, true, flags: JSON_THROW_ON_ERROR);
$responses[$response['id']] = $response;
}
return $responses;
}
}
Loading