laravel-forge-mcp

Laravel Forge MCP サーバー — Model Context Protocol を介して AI アシスタントに Forge API v2 の全機能を提供します。

このサーバーは公式の JSON:API v2 エンドポイント（https://forge.laravel.com/api）を使用します。レガシーな v1 API（/api/v1）は使用しません。

特徴

• サーバー、サイト、デプロイ、データベース、バックアップ、PHP、サービス、チーム、ロール、レシピなどをカバーする 約270のツール

• カーソルページネーション、フィルタリング、ソート、リレーションのインクルード

• レート制限の自動リトライ（429 + Retry-After）

• 組織スコープのパスと、FORGE_ORGANIZATION によるオプションのデフォルト組織

Related MCP server: Forge MCP Server

要件

• Node.js >= 20

• Forge API トークン

環境変数

FORGE_API_KEY は FORGE_API_TOKEN の代替として暗黙的に受け付けられます。

インストール

Cursor

ユーザー設定（~/.cursor/mcp.json）またはプロジェクト設定（.cursor/mcp.json）に追加します:

{
  "mcpServers": {
    "laravel-forge-mcp": {
      "command": "npx",
      "args": ["-y", "@vitrion/laravel-forge-mcp"],
      "env": {
        "FORGE_API_TOKEN": "your-forge-api-token",
        "FORGE_ORGANIZATION": "your-org-slug"
      }
    }
  }
}

Cursor 設定 → Tools & MCP からサーバーを追加することもできます。

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "laravel-forge-mcp": {
      "command": "npx",
      "args": ["-y", "@vitrion/laravel-forge-mcp"],
      "env": {
        "FORGE_API_TOKEN": "your-forge-api-token",
        "FORGE_ORGANIZATION": "your-org-slug"
      }
    }
  }
}

Claude Code

claude mcp add laravel-forge-mcp -- npx -y @vitrion/laravel-forge-mcp

シェル環境または MCP ホスト設定で FORGE_API_TOKEN（および必要に応じて FORGE_ORGANIZATION）を設定します。

ツールグループ

ツールはケバブケースで命名され、Forge API v2 の操作と一対一で対応しています:

一覧ツールは共通のクエリパラメータ（include、filter、sort、pageSize、cursor）をサポートしています。

開発

git clone https://github.com/vitrionbv/laravel-forge-mcp.git
cd laravel-forge-mcp
npm install
npm run build
npm test
npm run dev

インスペクター

公式インスペクターで MCP サーバーをデバッグします（ビルド済みの dist/ が必要です）:

npm run build
npm run inspector

または直接:

npx @modelcontextprotocol/inspector node dist/index.js

ライセンス

MIT — LICENSE を参照してください。

リポジトリ

vitrionbv/laravel-forge-mcp