Faber

Provides an MCP server to deploy and manage Laravel apps on Faber servers via AI-driven Cursor commands.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "joshtrebilco-faber-mcp": {
      "command": "faber-mcp",
      "args": []
    }
  }
}

You can deploy and manage Laravel applications on Faber servers directly from Cursor using the Faber MCP Server. It automates provisioning, deployment, domain and SSL setup, and real-time logs, so you can deploy with natural language commands and focus on building your app.

How to use

Use Cursor to issue natural language commands that interact with the Faber MCP Server. Common workflows include deploying a new project to production or staging, listing deployed apps, checking server status, or rolling back to a previous release. The MCP agent handles stack creation, GitHub deploy keys, environment configuration, and triggering deployments. If you deploy to multiple environments, specify the target server, such as production or staging, to apply the appropriate profile.

How to install

Prerequisites are Node.js installed on your workstation, SSH access to a Faber server, and the Faber CLI installed on target servers.

Step 1: Install the MCP server globally on your workstation.

npm install -g faber-mcp

Step 2: Install from source if you prefer to build locally.

git clone https://github.com/JoshTrebilco/faber-mcp.git`\n`cd faber-mcp`\n`npm install`\n`npm run build`\n`npm link`  # Makes it available globally

Available tools

faber_check_app

Check if an app exists on the server and retrieve its details.

faber_list_apps

List all deployed applications on the target server.

faber_create_stack

Create the full application stack, including environment setup and deploy key handling.

faber_deploy

Trigger a zero-downtime deployment for an app.

faber_get_deploy_key

Retrieve the SSH public deploy key for adding to the Git repository.

faber_server_status

Get the health status of the server and its services.

faber_service_restart

Restart core services such as nginx, PHP, MySQL, and Redis.

faber_list_domains

List all configured domains for apps on the server.

faber_create_domain

Create or assign a domain to a specific app.

faber_list_databases

List all databases on the server.

faber_create_database

Create a new database for an app.

faber_list_releases

List available releases for an app.

faber_rollback

Rollback an app to a previous release.

faber_webhook_logs

View webhook execution logs.

faber_app_logs

View Laravel application logs.

faber_get_env

Read the .env file for an app (read-only).

faber_set_env_var

Set a specific environment variable in an app's .env file.