Croft

Created By

ashleyhindle9 months ago

MCP server for all of your Laravel projects - better AI pair programming, coming soon..

Content

MCP server specifically for local Laravel development

Artisan command provides tools to your MCP client to help your AI pair programmer work better. This is specifically designed to offer tools that are useful locally. Add more functionality with croft.fyi » hosted servers

Installation

Install the package via composer:

composer require ashleyhindle/croft --dev

Publish the config file with:

php artisan vendor:publish --tag="croft-config"

Add more functionality with croft.fyi » hosted servers (coming soon)

Usage

To make use of Croft you need to add it as an MCP server in your favourite tool.

The command the MCP client needs to run is ./artisan croft

Cursor (Docs)

We recommend you ship an mcp.json file with your project in .cursor/mcp.json

{
  "mcpServers": {
    "croft": {
      "command": "./artisan",
      "args": ["croft"]
    }
  }
}

Current functionality

Screenshot URLs
InertiaJS docs
Query database (read only, or read write)
Get absolute URL from relative path
Get current date and time
Read last X log entries
Read & filter database structure - tables, columns, indexes, foreign keys
List/filter routes
List artisan commands
List available config() keys (and optionally values) in dot notation
List available env() keys (without leaking secrets of course)

Extra functionality

Add more functionality with croft.fyi » remote MCP servers (coming soon).

Add your own tools

It's trivial to add your own tools.

Just create a class that extends our Croft\Feature\Tool\AbstractTool class, then make sure it's in your croft.php config file.

Example:

<?php

declare(strict_types=1);

namespace Croft\Tools;

use Croft\Feature\Tool\AbstractTool;
use Croft\Feature\Tool\ToolResponse;

class {{CLASSNAME}} extends AbstractTool
{
    public function __construct()
    {
        // Setup annotations according to MCP specification
        $this->setTitle('{{NAME}}')
            ->setReadOnly(true)        // Just listing commands, no modifications
            ->setDestructive(false)    // No destructive operations
            ->setIdempotent(true);     // Safe to retry
    }

    public function getName(): string
    {
        return '{{NAME}}';
    }

    public function getDescription(): string
    {
        return 'Must explain well what the tool can do so the MCP client can decide when to use it.';
    }

    /**
    * What params does the MCP client need to provide to use this tool?
    **/
    public function getInputSchema(): array
    {
        return [
            'type' => 'object',
            'properties' => (object) [
            ],
            'required' => [],
        ];
    }

    public function handle(array $arguments): ToolResponse
    {
        return ToolResponse::text("Howdy, this is the start of something great.");
    }
}