Forge MCP Servidor

Forge MCP Server

Això és un servidor Model Context Protocol (MCP) per a la integració amb Laravel Forge. Proporciona accés complet a l'API oficial de Laravel Forge a través d'eines compatibles amb MCP, permetent una gestió sense interrupcions dels servidors i llocs.

Per a més informació sobre l'API de Laravel Forge, consulteu la documentació oficial de l'API.

Features

Servidor compatible amb MCP
Integració completa amb l'API de Laravel Forge
Eina de comprovació de salut: test_connection
Cobertura extensa d'eines per a la gestió de servidors i llocs
Construït sobre l'API oficial de Laravel Forge

Prerequisites

Node.js (recomanat v18+)
npm (recomanat v9+)

Configuration & Usage

Es requereix una clau d'API de Forge per a totes les invocacions d'eines de Forge. Ha de proporcionar-la com a una de les següents:

la variable d'entorn FORGE_API_KEY, o
l'argument de línia de comandes --api-key

Usage with Claude Desktop

Afegeix el següent al teu claude_desktop_config.json. Vegeu aquí per a més detalls.

Option 1: Using npx (Recommended)

Using environment variable:

{
  "mcpServers": {
    "forge-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ranium/forge-mcp"
      ],
      "env": {
        "FORGE_API_KEY": "your_forge_api_key_here"
      }
    }
  }
}

Using command-line argument:

{
  "mcpServers": {
    "forge-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ranium/forge-mcp",
        "--api-key=your_forge_api_key_here"
      ]
    }
  }
}

Option 2: Using node directly

Primer, clona el repositori i construeix el projecte:

git clone https://github.com/ranium/forge-mcp-server
cd forge_mcp
npm install
npm run build

Després afegeix el següent al teu claude_desktop_config.json:

Using environment variable:

{
  "mcpServers": {
    "forge-mcp": {
      "command": "node",
      "args": [
        "/path/to/forge_mcp/dist/server.js"
      ],
      "env": {
        "FORGE_API_KEY": "your_forge_api_key_here"
      }
    }
  }
}

Using command-line argument:

{
  "mcpServers": {
    "forge-mcp": {
      "command": "node",
      "args": [
        "/path/to/forge_mcp/dist/server.js",
        "--api-key=your_forge_api_key_here"
      ]
    }
  }
}

Note: Podeu utilitzar la variable d'entorn FORGE_API_KEY o l'argument --api-key. Si es proporcionen ambdues, l'argument de línia de comandes té precedència. No commitis mai les teves claus d'API reals al control de versions. Utilitza variables d'entorn o gestió de secrets en producció.

Tool Categories & Access Control

Totes les eines es agrupen en dues categories:

Readonly: Operacions segures i sense modificar (p. ex., llistat, visualització, comprovacions d'estat).
Write: Operacions que creen o modifiquen recursos (p. ex., crear, actualitzar, reiniciar, habilitar/deshabilitar funcions).

Per defecte, només s'activen les eines readonly. Per habilitar les eines write, utilitza la bandera --tools:

--tools=readonly (per defecte)
--tools=readonly,write (habilita les eines readonly i write)

Example:

npx -y @ranium