Skip to content
Draft
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
5 changes: 5 additions & 0 deletions resources/boost/guidelines/core.blade.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Laravel MCP

- Laravel MCP allows you to rapidly build MCP servers for your Laravel applications.
- IMPORTANT: laravel/mcp is very new. Always use the `search-docs` tool for authoritative documentation on writing and testing Laravel MCP servers, tools, resources, and prompts.
- IMPORTANT: Activate `mcp-development` every time you're working with an MCP-related task.
75 changes: 75 additions & 0 deletions resources/boost/skills/mcp-development/SKILL.blade.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
name: mcp-development
description: "Develops MCP servers, tools, resources, and prompts. Activates when creating MCP tools, resources, or prompts; setting up AI integrations; debugging MCP connections; working with routes/ai.php; or when the user mentions MCP, Model Context Protocol, AI tools, AI server, or building tools for AI assistants."
license: MIT
metadata:
author: laravel
---
@php
/** @var \Laravel\Boost\Install\GuidelineAssist $assist */
@endphp
# MCP Development

## When to Apply

Activate this skill when:

- Creating MCP tools, resources, or prompts
- Setting up MCP server routes
- Debugging MCP connection issues

## Documentation

Use `search-docs` for detailed Laravel MCP patterns and documentation.

## Basic Usage

Register MCP servers in `routes/ai.php`:

@boostsnippet("Register MCP Server", "php")
use Laravel\Mcp\Facades\Mcp;

Mcp::web();
@endboostsnippet

### Creating MCP Primitives

Create MCP tools, resources, prompts, and servers using artisan commands:

@boostsnippet("MCP Artisan Commands", "bash")
{{ $assist->artisanCommand('make:mcp-tool ToolName') }} # Create a tool
{{ $assist->artisanCommand('make:mcp-resource ResourceName') }} # Create a resource
{{ $assist->artisanCommand('make:mcp-prompt PromptName') }} # Create a prompt
{{ $assist->artisanCommand('make:mcp-server ServerName') }} # Create a server
@endboostsnippet

After creating primitives, register them in your server's `$tools`, `$resources`, or `$prompts` properties.

### Tools

@boostsnippet("MCP Tool Example", "php")
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Request;
use Laravel\Mcp\Server\Response;

class MyTool extends Tool
{
public function handle(Request $request): Response
{
return new Response(['result' => 'success']);
}
}
@endboostsnippet

## Verification

1. Check `routes/ai.php` for proper registration
2. Test tool via MCP client

## Common Pitfalls

- Running `mcp:start` command (it hangs waiting for input)
- Using HTTPS locally with Node-based MCP clients
- Not using `search-docs` for the latest MCP documentation
- Not registering MCP server routes in `routes/ai.php`
- Do not register `ai.php` in `bootstrap.php`; it is registered automatically.