Croft

🚀 ローカルLaravel開発用のCroft MCPサーバー

Artisanコマンドを使うことで、ChatGPTなどのAIコードアシスタントをLaravelと組み合わせた際の性能を向上させるツールを提供します。

このプロジェクトは、特にローカル開発環境に最適化されています。croft.fyi が提供するホストサービスを通じて、さらに多くの機能を追加できます。

🚀 クイックスタート

このサーバーを使用することで、Artisanコマンドを通じてAIコードアシスタントの性能を向上させ、ローカルLaravel開発を支援することができます。

✨ 主な機能

• スクリーンショットURLリンク
• 現在の日付と時間の取得
• 最近のX件のログ記録の表示
• データベース構造の表示とフィルタリング - テーブル、フィールド、インデックス、外部キー
• ルートのリスト表示とフィルタリング
• artisanコマンドのリスト表示
• 利用可能なconfig()キー（ドット表記）のリスト表示
• 利用可能なenv()キーのリスト表示（当然、シークレットは漏洩しません）

📦 インストール

Composerを使用してパッケージをインストールします。

composer require ashleyhindle/croft --dev

設定ファイルを公開します。

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

croft.fyi が提供するホストサービスを通じて、さらに多くの機能を追加できます。

💻 使用例

基本的な使用法

Croftを使用するには、MCPサーバーとしてお好みのツールに追加する必要があります。MCPクライアントが実行する必要があるコマンドは ./artisan croft です。

Cursorの設定

Cursor を使用する場合、プロジェクトのルートディレクトリに .cursor/mcp.json ファイルを作成することをおすすめします。

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

高度な使用法

カスタムツールの追加

独自のツールを追加するには、Croft\Feature\Tool\AbstractTool クラスを拡張する新しいクラスを作成し、croft.php 設定ファイルに登録するだけです。

<?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()
    {
        // MCP規格に基づいて注釈を設定
        $this->setTitle('{{NAME}}')
            ->setReadOnly(true)        // コマンドをリスト表示のみ、変更しない
            ->setDestructive(false)    // 破壊的な操作を実行しない
            ->setIdempotent(true);     // 安全に再試行可能
    }

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

    public function getDescription(): string
    {
        return 'このツールの機能を詳細に説明する必要があり、MCPクライアントがいつ使用するかを判断できるようにします。';
    }

    /**
    * MCPクライアントがこのツールを使用するために提供する必要があるパラメーターは何ですか？
    **/
    public function getInputSchema(): array
    {
        return [
            'type' => 'object',
            'properties' => (object) [
            ],
            'required' => [],
        ];
    }

    public function handle(array $arguments): ToolResponse
    {
        return ToolResponse::text("こんにちは、素晴らしいことの始まりです。");
    }
}

ツールを追加した後は、サーバーを再起動するか、MCPクライアントで利用可能なツールを再リスト表示する必要があります。

🔧 追加機能

croft.fyi が提供するホストサービスを通じて、さらに多くの機能を追加できます。

📄 開発者情報

このプロジェクトは Ashley Hindle によって開発されています。もし気に入ったら、いいねや共有をして、ぜひ教えてください！

• Blue Sky
• Twitter
• ウェブサイト https://ashleyhindle.com