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)는 사용하지 않습니다.

기능

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

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

• 자동 속도 제한 재시도 (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

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

도구 그룹

도구는 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