laravel-forge-mcp
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 설정에서 발급받은 Bearer 토큰 |
| 아니요 | 조직 범위 도구에 사용할 기본 조직 슬러그 |
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 참조.
저장소
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
Related MCP Servers
- AlicenseDqualityDmaintenanceA minimalist MCP server that integrates with Laravel Forge, allowing users to manage their Laravel Forge servers, sites, and deployments through AI assistants like Claude Desktop, Windsurf, or Cursor.12MIT
- AlicenseNot gradedqualityDmaintenanceIntegrates with the Laravel Forge API to provide comprehensive management of servers and sites. It enables users to perform health checks, monitor logs, create resources, and execute deployment tasks through MCP-compliant tools.52 npm2MIT
- AlicenseBqualityDmaintenanceMCP server for managing Laravel Forge servers, sites, and deployments via the Forge API.1218 npm9MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to fully manage Laravel Forge servers, sites, databases, workers, daemons, SSL certificates, and deployments.3918 npmMIT