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

laravel-forge-mcp

npm version License: MIT Node.js Version 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

环境要求

环境变量

变量

必需

描述

FORGE_API_TOKEN

是

来自 Forge API 设置 的 Bearer 令牌

FORGE_ORGANIZATION

否

组织作用域工具的默认组织 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。

仓库

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