Laravilt

Laravilt MCP

AI アシスタントに、すべての laravilt/* パッケージ（プラグインシステムおよび Vue／React フロントエンドを含む）の最新の Laravilt ドキュメント、README、変更履歴、リリース済みバージョンを提供する、公開読み取り専用の Model Context Protocol サーバーです。

エンドポイント：https://mcp.laravilt.com/mcp（ストリーミング可能な HTTP、認証不要、IP ごとのレート制限あり）。

接続

Claude Code

claude mcp add --transport http laravilt https://mcp.laravilt.com/mcp

Cursor／VS Code（.cursor/mcp.json または .vscode/mcp.json）

{
    "mcpServers": {
        "laravilt": { "type": "http", "url": "https://mcp.laravilt.com/mcp" }
    }
}

Claude Desktop（mcp-remote 経由）

{
    "mcpServers": {
        "laravilt": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.laravilt.com/mcp"] }
    }
}

その他のクライアントでは、ストリーミング可能な HTTP URL https://mcp.laravilt.com/mcp を使用してください。

ツール

ツール	返される内容
list-packages	説明、最新バージョン、リリース日、インストールコマンド、リポジトリを含む、すべての Laravilt パッケージ
get-package	1 つのパッケージの README の概要、最新バージョン、要件、フロントエンドに関する注記（Vue および React）、ドキュメントのインデックス、最近の変更履歴
search-docs	パスと GitHub リンク付きの、関連度順に並んだドキュメントの抜粋（パッケージを指定して絞り込むこともできます）
read-doc	ドキュメント全文。長いページはページ分割されます
list-docs	1 つまたはすべてのパッケージのドキュメントツリー
get-latest-versions	package => version のマップと、そのまま貼り付けられる composer require の行
get-changelog	パッケージの最近の変更履歴エントリー
plugin-development-guide	laravilt/plugins のドキュメントをまとめた、Laravilt プラグインの構築方法
installation-guide	php artisan laravilt:install --stack=vue|react を使って Laravel 13 に Laravilt をインストールする方法

リソース： laravilt://packages および、同期されたすべてのドキュメントを対象とする laravilt://docs/{package}/{path}。プロンプト： build-resource。

コンテンツを最新に保つ方法

php artisan laravilt:sync は laravilt の GitHub 組織をスキャンし、各パッケージのデフォルトブランチを tarball としてダウンロードします。README.md、CHANGELOG.md、composer.json、および docs/ 以下のすべての Markdown ファイルにインデックスを付け、Packagist からリリース済みバージョンを記録します。変更のないコミットはスキップされます。スケジューラーは 30 分ごとに実行され、GitHub webhook（GITHUB_WEBHOOK_SECRET で署名された POST /webhooks/github）は、プッシュされたリポジトリの同期を即座にキューに追加します。

ローカル開発

composer install
cp .env.example .env && php artisan key:generate
touch database/database.sqlite
php artisan migrate
php artisan laravilt:sync
php artisan serve

次に、ランディングページを表示するには http://127.0.0.1:8000 を開くか、MCP クライアントの接続先を http://127.0.0.1:8000/mcp に設定してください。

php artisan test
vendor/bin/pint

設定

変数	デフォルト	用途
APP_URL		公開 URL。例：https://mcp.laravilt.com
LARAVILT_GITHUB_ORG	laravilt	パッケージのスキャン対象となる組織
LARAVILT_EXCLUDED_REPOS	mcp,laravilt.com,laravilt-dev,.github	パッケージではないリポジトリ
GITHUB_TOKEN		任意。GitHub API のレート制限を引き上げます
GITHUB_WEBHOOK_SECRET		プッシュ webhook の受け付けに必要です
LARAVILT_SYNC_INTERVAL	30	スケジュールされた同期の間隔（分）
LARAVILT_SEARCH_DRIVER	auto	auto、fts（SQLite FTS5）、または like
LARAVILT_DOC_PAGE_SIZE	16000	read-doc のページあたりの文字数
LARAVILT_RATE_LIMIT	120	IP ごとの MCP リクエスト数（毎分）
LARAVILT_MCP_PATH	mcp	MCP エンドポイントのパス
TRUSTED_PROXIES		プロキシの IP／CIDR（リバースプロキシの背後で実行する場合に設定）

デプロイ

1. composer install --no-dev --optimize-autoloader を実行し、.env.example から .env を作成して、php artisan key:generate、php artisan migrate --force を実行します。
2. php artisan laravilt:sync を一度実行します。
3. スケジューラーを毎分実行し（php artisan schedule:run）、webhook によってトリガーされた同期のためのキューワーカーを起動します（php artisan queue:work、または QUEUE_CONNECTION=sync）。
4. Web サーバーまたはリバースプロキシの背後で PHP-FPM を使って public/ を配信し、TRUSTED_PROXIES を設定します。
5. 各 Laravilt リポジトリ（または組織）で、プッシュイベント用の webhook を https://mcp.laravilt.com/webhooks/github に追加し、同じシークレットを使用します。

ライセンス

MIT