MCP Bundle

Symfony integration bundle for Model Context Protocol using the unofficial PHP SDK php-llm/mcp-sdk library.

Installation

composer require php-llm/mcp-bundle

Usage

At first, you need to decide whether your application should act as a MCP server or client. Both can be configured in the mcp section of your config/packages/mcp.yaml file.

Act as Client

To use your application as a MCP client, integrating other MCP servers, you need to configure the servers you want to connect to. You can use either STDIO or Server-Sent Events (SSE) as transport methods.

You can find a list of example Servers in the MCP Server List.

Tools of those servers are available in your LLM Chain Bundle configuration and usable in your chains.

Act as Server

To use your application as an MCP server, exposing tools to clients like Claude Desktop, you need to configure in the client_transports section the transports you want to expose to clients. You can use either STDIO or SSE.

Configuration

mcp:
    app: 'app' # Application name to be exposed to clients
    version: '1.0.0' # Application version to be exposed to clients
    
    # Configure MCP servers to be used by this application
    servers:
        name:
            transport: 'stdio' # Transport method to use, either 'stdio' or 'sse'
            stdio:
                command: 'php /path/bin/console mcp' # Command to execute to start the client
                arguments: [] # Arguments to pass to the command
            sse:
                url: 'http://localhost:8000/sse' # URL to SSE endpoint of MCP server
        
    # Configure this application to act as an MCP server
    client_transports:
        stdio: true # Enable STDIO via command
        sse: true # Enable Server-Sent Event via controller