laravel-forge-mcp

Laravel Forge MCP server — полное покрытие Forge API v2 для AI-ассистентов через Model Context Protocol.

Этот сервер использует официальные эндпоинты JSON:API v2 (https://forge.laravel.com/api). Он не использует устаревший API v1 (/api/v1).

Возможности

• ~270 инструментов, покрывающих серверы, сайты, деплои, базы данных, бэкапы, PHP, сервисы, команды, роли, рецепты и многое другое

• Курсорная пагинация, фильтрация, сортировка и включение связей

• Автоматический повтор при rate-limit (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 Settings → 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

Установите FORGE_API_TOKEN (и, опционально, FORGE_ORGANIZATION) в вашем окружении shell или в конфиге MCP-хоста.

Группы инструментов

Инструменты названы в kebab-case и сопоставляются один к одному с операциями 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