Search by

symfony / ai-mcp-tool

fabpot

Model Context Protocol AI tool bridge for Symfony applications.

Package info

github.com/symfony/ai-mcp-tool

Type:symfony-ai-tool

pkg:composer/symfony/ai-mcp-tool

Security

Advisories: 0

Aikido package health analysis

Transparency log

Fund package maintenance!

fabpot

nicolas-grekas

symfony.com/sponsor

Tidelift

Statistics

Installs: 1

Dependents: 2

Suggesters: 0

Stars: 0

dev-main 2026-09-14 23:58 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT d9a5ee6419577b7b843fc10120f3540dd78cf306

toolBridgeAgentaimcpmodel-context-protocol

Published on Packagist.org on 2026-09-16 06:40 UTC

This package is auto-updated.

Last update: 2026-09-16 06:40:42 UTC

README

Exposes the tools advertised by a remote Model Context Protocol server to a Symfony AI Agent.

An agent is not an MCP client: it never asks a server for a prompt or reads one of its resources, it only draws tools from it. The bridge therefore models a toolset behind an MCP connection rather than the server itself. A server answering tools/list and tools/call already is a toolbox, so it becomes one: McpToolbox turns the server's tool list into Symfony\AI\Platform\Tool\Tool definitions and forwards every call, without reflecting on them the way local #[AsTool] services are handled. Tool names are prefixed with the server's short name — a read_file tool on a server named filesystem becomes filesystem_read_file — so several servers can be attached to the same agent without their names colliding.

Standalone, a toolset is reached through the official mcp/sdk client:

use Mcp\Client;
use Mcp\Client\Transport\StdioTransport;
use Symfony\AI\Agent\Agent;
use Symfony\AI\Agent\Bridge\Mcp\ClientToolset;
use Symfony\AI\Agent\Bridge\Mcp\McpToolbox;

$toolset = new ClientToolset('filesystem', Client::builder()->build(), new StdioTransport('npx', ['-y', '@modelcontextprotocol/server-filesystem', __DIR__]));

$agent = new Agent($platform, 'gpt-4o-mini', toolbox: new McpToolbox($toolset));

In a Symfony application, configure the connection once with the MCP bundle's mcp.clients: option and point an agent at it with an mcp_server: entry in the AI bundle's tools: list instead — the bundles adapt the already-configured connection rather than opening a second one.

Resources