Skip to content

v2.0.0
Compare
Choose a tag to compare
@CodeWithKyrian CodeWithKyrian released this 04 Jun 13:43
· 10 commits to main since this release
2.0.0
7f02775

This release marks a major overhaul, bringing it into full alignment with php-mcp/server v2.1.0+ and introducing a significantly improved, more "Laravely" developer experience.

Added

  • Fluent Manual Registration API:
    • Introduced the Mcp Facade (PhpMcp\Laravel\Facades\Mcp).
    • Define Tools, Resources, Prompts, and Resource Templates fluently (e.g., Mcp::tool(...)->description(...)).
    • Definitions are typically placed in routes/mcp.php (configurable).
    • Handlers are resolved via Laravel's service container, allowing dependency injection.
  • Dedicated HTTP Server Transport via mcp:serve:
    • The php artisan mcp:serve --transport=http command now launches a standalone, high-performance ReactPHP-based HTTP server using \PhpMcp\Server\Transports\HttpServerTransport.
    • Configuration for this dedicated server is in config/mcp.php under transports.http_dedicated.
    • CLI options (--host, --port, --path-prefix) can override config defaults.
  • LaravelHttpTransport for Integrated HTTP:
    • New PhpMcp\Laravel\Transports\LaravelHttpTransport class implements ServerTransportInterface to bridge Laravel's HTTP request lifecycle with the core MCP Protocol handler.
  • Configurable Auto-Discovery:
    • config('mcp.discovery.auto_discover') (default: true) now controls whether discovery runs automatically or not. You can set it to false in production..
  • Interactive Prompt for mcp:serve: If --transport is not specified, the command now interactively prompts the user to choose between stdio and http.

Changed

  • Core Server Integration: Now uses \PhpMcp\Server\Server::make() (ServerBuilder) for all server instantiation, fully leveraging php-mcp/server v2.x architecture.
  • Namespace: Base package namespace changed from PhpMcp\Laravel\Server to PhpMcp\Laravel.
  • Configuration (config/mcp.php):
    • Significantly restructured and updated to align with ServerBuilder options.
    • Clearer separation of settings for http_dedicated vs. http_integrated transports.
    • Simplified cache TTL (cache.ttl) and discovery (discovery.save_to_cache_on_discover) keys.
    • Added server.instructions for the initialize MCP response.
    • Added discovery.exclude_dirs and discovery.definitions_file.
  • McpServiceProvider:
    • Completely rewritten to correctly build and configure the \PhpMcp\Server\Server instance using Laravel's services for logging, caching (with fallback to core FileCache), container, and event loop.
    • Loads manual definitions from the configured definitions_file via McpRegistrar.
    • Sets up core Registry notifiers to dispatch Laravel events for list changes.
  • McpController (Integrated HTTP): More robustly handles the integrated server behavior, working with a custom LaravelHttpTransport.
  • Artisan Commands:
    • mcp:discover: Now directly calls Server::discover() with configured/CLI parameters. force option behavior clarified.
    • mcp:list: Fetches elements from the live, fully configured Registry from the resolved Server instance.
    • mcp:serve: Refactored to use core StdioServerTransport or HttpServerTransport directly.
  • Dependency: Updated php-mcp/server to ^2.2.0

Fixed

  • More robust error handling and logging in Artisan commands and McpController.
  • Improved clarity and consistency in how core server components are resolved and used within the Laravel context.

Removed

  • PhpMcp\Laravel\Server\Adapters\ConfigAdapter: No longer needed due to changes in php-mcp/server v2.x.

BREAKING CHANGES

  • Namespace Change: The primary package namespace has changed from PhpMcp\Laravel\Server to PhpMcp\Laravel. Update all use statements and FQCN references in your application. You may have to uninstall and reinstall the package to avoid conflicts.
  • Configuration File: The config/mcp.php file has been significantly restructured. You must republish and merge your customizations: 
    php artisan vendor:publish --provider="PhpMcp\Laravel\McpServiceProvider" --tag="mcp-config" --force
  • mcp:serve for HTTP: The --transport=http option for mcp:serve now launches a dedicated ReactPHP-based server process. For serving MCP via your main Laravel application routes, ensure the http_integrated transport is enabled in config/mcp.php and your web server is configured appropriately.
  • Event Handling: If you were directly listening to internal events from the previous version, these may have changed. Rely on the documented Laravel events (ToolsListChanged, etc.).
  • Removed Classes: PhpMcp\Laravel\Server\Adapters\ConfigAdapter is removed.

Full Changelog: 1.1.1...2.0.0

Assets 2
Loading