laravel-forge-mcp
laravel-forge-mcp
Laravel Forge MCP 服务器 — 通过模型上下文协议为 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 设置 的 Bearer 令牌 |
| 否 | 组织作用域工具的默认组织 slug |
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 设置 → 工具与 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在 shell 环境或 MCP 主机配置中设置 FORGE_API_TOKEN(以及可选的 FORGE_ORGANIZATION)。
工具分组
工具以 kebab-case 命名,并与 Forge API v2 操作一一对应:
分组 | 示例 |
用户与组织 | 当前用户、组织列表、服务器凭据、VPC |
服务器 | CRUD、操作(重启)、归档、网络、事件 |
站点 | 全局/组织/服务器站点、环境、nginx、健康、负载均衡、composer/npm 凭据 |
域名与证书 | 域名、DNS、nginx、证书、域名操作 |
部署 | 部署、脚本、推送到部署、部署钩子/密钥、Webhook |
后台进程 | 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…
This server cannot be deployed
Maintenance
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