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_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 操作一一对应：

列表工具支持共享查询参数：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