Skip to main content
Glama
laravel-forge-mcp
by vitrionbv

laravel-forge-mcp

npm version License: MIT Node.js Version MCP

Laravel Forge MCP 서버 — Model Context Protocol을 통해 AI 어시스턴트에 Forge API v2 전체를 제공합니다.

이 서버는 공식 JSON:API v2 엔드포인트 (https://forge.laravel.com/api)를 사용합니다. 레거시 v1 API (/api/v1)는 사용하지 않습니다.

기능

  • 약 270개의 도구 — 서버, 사이트, 배포, 데이터베이스, 백업, PHP, 서비스, 팀, 역할, 레시피 등을 포함

  • 커서 페이지네이션, 필터링, 정렬, 관계 포함

  • 자동 속도 제한 재시도 (429 + Retry-After)

  • FORGE_ORGANIZATION을 통한 선택적 기본 조직을 지원하는 조직 범위 경로

Related MCP server: Forge MCP Server

요구 사항

환경 변수

변수

필수

설명

FORGE_API_TOKEN

예

Forge API 설정에서 발급받은 Bearer 토큰

FORGE_ORGANIZATION

아니요

조직 범위 도구에 사용할 기본 조직 슬러그

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

셸 환경 또는 MCP 호스트 구성에 FORGE_API_TOKEN(및 선택적으로 FORGE_ORGANIZATION)을 설정하세요.

도구 그룹

도구는 kebab-case로 명명되며 Forge API v2 작업과 일대일로 매핑됩니다:

그룹

예시

사용자 및 조직

현재 사용자, 조직 목록, 서버 자격 증명, VPC

서버

CRUD, 작업(재부팅), 아카이브, 네트워크, 이벤트

사이트

글로벌/조직/서버 사이트, env, nginx, 상태, 로드 밸런싱, composer/npm 자격 증명

도메인 및 인증서

도메인, DNS, nginx, 인증서, 도메인 작업

배포

배포, 스크립트, push-to-deploy, 배포 훅/키, 웹훅

백그라운드 프로세스

CRUD, 로그, 시작/중지/재시작 작업

데이터베이스 및 백업

스키마, 사용자, 백업 구성/인스턴스, 복원

스토리지 제공자

S3 호환 백업 스토리지 CRUD

예약 작업 및 명령

서버/사이트 cron 작업, 사이트 명령

방화벽, SSH 및 모니터

방화벽 규칙, SSH 키, 가동 시간 모니터, 서버 로그

Nginx, 보안 및 리디렉션

템플릿, 보안 규칙, 리디렉션 규칙

통합 및 로그

Horizon, Octane, Reverb, Pulse, 사이트 로그, 하트비트

레시피

조직 레시피, forge 레시피, 팀 공유

팀 및 역할

팀, 구성원, 초대, 공유, 역할, 권한

제공자

클라우드 제공자, 크기, 지역

PHP 및 서비스

PHP 버전/구성/OPcache, 서비스 작업(nginx, mysql, redis, …)

목록 도구는 공통 쿼리 매개변수 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers