Download the PHP package redberry/mcp-client-laravel without Composer
On this page you can find all versions of the php package redberry/mcp-client-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package mcp-client-laravel
MCP Client for Laravel
A Laravel client for the Model Context Protocol. It speaks JSON-RPC 2.0 over both Streamable HTTP (2025-03-26) and STDIO, and exposes a single facade for listing and calling tools and reading resources. The HTTP transport content-negotiates with the server on every request, so you receive the final result whether the server replies with one JSON object or a stream of server-sent events.
Installation
Install the package via Composer:
Then publish the configuration file:
This will create a config/mcp-client.php file in your application.
Configuration
The mcp-client.servers array maps a server name to its connection details. Each server uses one of two transports — HTTP for remote servers, STDIO for local subprocesses:
HTTP Transport
The HTTP transport implements MCP's Streamable HTTP transport. On the first request, it performs the initialize handshake and captures the mcp-session-id for the rest of the session. If the server later signals that the session has expired with an HTTP 404, the client clears its session, re-handshakes, and retries the call once.
| Key | Default | Description |
|---|---|---|
base_url |
— | The MCP endpoint URL. |
token |
null |
Bearer token; sent as Authorization: Bearer {token} when present. |
timeout |
30 |
Connection timeout in seconds. |
read_timeout |
60 |
Maximum gap between SSE chunks before the parser aborts a wedged stream. The clock resets on every chunk. Set to null to disable. |
max_session_retries |
1 |
Automatic retries after a session-loss 404. Set to 0 to disable. |
headers |
[] |
Additional headers merged into every request. |
id_type |
'int' |
'int' or 'string'; controls how JSON-RPC ids are cast. |
STDIO Transport
The STDIO transport launches the configured command as a subprocess and exchanges newline-delimited JSON-RPC over its standard streams. The subprocess starts lazily on the first call and is reused for every subsequent request.
| Key | Default | Description |
|---|---|---|
command |
— | Array of command parts to launch. |
cwd |
null |
Working directory for the subprocess. |
env |
null |
Environment variables, merged on top of the parent environment. |
inherit_env |
true |
When false, the subprocess receives only the keys listed in env. |
request_timeout |
30 |
Per-call wait for a JSON-RPC response, in seconds. Falls back to the legacy timeout key when only that is set. |
process_timeout |
null |
Symfony Process kill timer, in seconds. Set this only if you need a hard upper bound on the subprocess lifetime. |
startup_delay |
100 |
Milliseconds to wait after Process::start() before sending the initialize handshake. Increase if a cold-start npx -y … is still booting when the handshake fires. |
poll_interval |
20 |
Milliseconds between reads of the subprocess output buffer. |
Note. The STDIO transport does not work under
php artisan serve. The built-in PHP development server tears down its worker between requests, which kills the long-running subprocess. Run your application via Octane, a queue worker, Sail, or Valet to use STDIO servers.
Connecting to a Server
Resolve the client and call connect with a server name from your configuration:
The container binds the client as a singleton and aliases the Redberry\MCPClient\Contracts\MCPClient interface to it, so the facade and dependency injection on the contract resolve the same instance:
connect returns a per-server clone of the client, so you may hold handles to multiple servers at once without one routing through another:
Repeated connect calls for the same server reuse a cached transporter, so the initialize handshake is paid once per server per root instance.
Listing Tools and Resources
The tools and resources methods return a Collection of associative arrays:
The same Collection wraps both lists, but only and except know which key to filter on — name for tools and uri for resources.
Calling a Tool
Pass the tool name and an associative array of arguments. The method returns the decoded JSON-RPC result array:
Reading a Resource
Pass the URI of the resource. The method returns the decoded JSON-RPC result array:
Streaming Events
Both callTool and readResource accept an optional callback as the last argument. When the server replies with an SSE stream, the callback is invoked for every decoded JSON-RPC message — progress notifications, log entries, partial results, and the final result-bearing one — as each arrives. The call still blocks until the final result is returned:
The callback is invoked zero times when the server replies with a single JSON object, so it is safe to pass unconditionally. Streaming is an HTTP-only concept; the callback is a no-op under the STDIO transport.
Custom Transports
The package ships with HTTP and STDIO transports, and the IO seam is a single interface — Redberry\MCPClient\Core\Transporters\Transporter. To add another, implement the interface, register a case on Redberry\MCPClient\Enums\Transporters, and add a match arm to TransporterFactory::make. See .claude/rules/transporters.md for the full contract.
Testing
Upgrading
Upgrading from 1.x to 2.x? See UPGRADE.md for the migration guide.
Changelog
See CHANGELOG.md for the list of changes.
Contributing
See CONTRIBUTING.md for guidelines.
Security Vulnerabilities
Please review our security policy before reporting a vulnerability.
Credits
- Nika Jorjoliani
- All Contributors
Built and maintained by Redberry, a Diamond-tier Laravel partner. We also run a 5-week AI agent PoC sprint for teams exploring agentic features in Laravel.
License
The MIT License (MIT). Please see LICENSE.md for more information.
All versions of mcp-client-laravel with dependencies
spatie/laravel-package-tools Version ^1.16
illuminate/contracts Version ^10.0||^11.0||^12.0||^13.0