Laravel Helper Tools

🚀 Laravel ツール MCP

Cursor IDE との統合を目的とした、Laravel の開発ワークフローとデバッグ能力を向上させる一連のツールです。

🚀 クイックスタート

このパッケージは、現在アルファ版です。API や機能は予告なく変更される可能性があります。本番環境での使用は自己責任で行ってください。

✨ 主な機能

このパッケージは、Cursor IDE での Laravel 開発体験を強化するために構築されています。すべてのツールは、Cursor のコマンドパレットから直接アクセスでき、開発フローとシームレスに統合されます。

利用可能なツール

• tail_log_file：Cursor 内で Laravel ログファイルの最新のエントリを表示します。
• search_log_errors：特定のエラーパターンを検索し、結果をエディタ内に直接表示します。
• run_artisan_command：Cursor から直接 Laravel Artisan コマンドを実行します。
• show_model：モデル情報と関係をエディタ内に表示します。

📦 インストール

手順

1. リポジトリをクローンします。

git clone https://github.com/your-username/laravel-mcp.git
cd laravel-mcp

2. シェルスクリプトのラッパーを作成します（例: ~/bin/run-laravel-mcp）。

#!/bin/bash

# Laravel プロジェクトのパスを指定します。
export LARAVEL_PATH=/path/to/your/laravel/project

# MCP サーバーを起動します。
mcp run /path/to/laravel-helpers-mcp/server.py

3. スクリプトに実行権限を付与します。

chmod +x ~/bin/run-laravel-mcp

4. ~/bin が PATH に含まれていることを確認します。

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc  # または ~/.bashrc
source ~/.zshrc  # または source ~/.bashrc

📚 ドキュメント

互換性要件

• PHP 8.1 以上
• Laravel 10.0 以上
• Cursor IDE
• UV - 最新の Python ラッパーツール

貢献ガイド

このプロジェクトは現在積極的に開発されています。問題の報告やプルリクエストは大歓迎です。

📄 ライセンス

[許可タイプ] - 詳細は LICENSE ファイルを参照してください。

⚠️ 重要提示

このパッケージは現在アルファ版です。API や機能は予告なく変更される可能性があります。本番環境での使用は自己責任で行ってください。