Laravel Forge MCP Server (Extended)

Laravel Forge MCP Server (Extended)

A comprehensive Model Context Protocol (MCP) server for interacting with Laravel Forge API. This server enables AI assistants to fully manage Laravel Forge servers, sites, databases, workers, daemons, SSL certificates, and deployments.

Attribution

This project is a fork of bretterer/forge-mcp-server by @bretterer.

Original features by bretterer:

• Server listing and details
• Site management (list, get)
• Deployment triggering and script management
• Quick deploy toggle
• Server reboot and load metrics

Extended by OBS Technologies:

• Site creation and deletion
• Git repository installation/removal
• Environment file management (.env)
• SSL certificate management (Let's Encrypt)
• Nginx configuration
• Database management (create, list, delete)
• Queue workers (create, list, delete, restart)
• Scheduled jobs/cron (create, list, delete)
• Daemons (create, list, delete, restart) - perfect for Laravel Horizon
• PHP version listing
• Site aliases management
• Improved error handling

Features

Server Management

• List and get details of Laravel Forge servers
• View server load metrics (CPU, memory, disk)
• Reboot servers
• List installed PHP versions

Site Management

• Create new sites with custom domains
• Delete sites
• Update domain aliases
• Configure PHP version per site
• Isolated site users

Deployment

• Deploy sites
• View deployment history
• Get/update deployment scripts
• Toggle quick deploy (auto-deploy on git push)
• Reset stuck deployment states

Git Integration

• Install Git repositories (GitHub, GitLab, Bitbucket)
• Remove Git repositories
• Configure composer install on deploy

Environment & Configuration

• Get/update .env files
• Get/update Nginx configuration

SSL Certificates

• List SSL certificates
• Obtain Let's Encrypt certificates
• Activate certificates

Database Management

• List databases
• Create databases with optional user
• Delete databases

Queue Workers

• List workers
• Create workers (connection, queue, timeout, processes)
• Delete workers
• Restart workers

Scheduled Jobs (Cron)

• List scheduled jobs
• Create scheduled jobs with cron frequency
• Delete scheduled jobs

Daemons

• List daemons
• Create daemons (perfect for Laravel Horizon)
• Delete daemons
• Restart daemons

Installation

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

Configuration

Prerequisites

You need a Laravel Forge API key. Get one from your Laravel Forge account settings.

Claude Code Configuration

Add to your ~/.claude/settings.json:

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

Claude Desktop Configuration

Add to your claude_desktop_config.json:

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

Available Tools (37 Total)

Server Tools

| Tool | Description | |------|-------------| | list_servers | List all Laravel Forge servers | | get_server | Get details of a specific server | | get_server_load | Get server load metrics | | reboot_server | Reboot a server |

Site Tools

| Tool | Description | |------|-------------| | list_sites | List all sites on a server | | get_site | Get details of a specific site | | create_site | Create a new site | | delete_site | Delete a site | | update_site_aliases | Update domain aliases |

Deployment Tools

| Tool | Description | |------|-------------| | deploy_site | Deploy a site | | get_deployments | Get deployment history | | get_deployment_script | Get deployment script | | update_deployment_script | Update deployment script | | toggle_quick_deploy | Enable/disable quick deploy | | reset_deployment_state | Reset stuck deployments |

Git Tools

| Tool | Description | |------|-------------| | install_git_repository | Install Git repo on site | | remove_git_repository | Remove Git repo from site |

Environment Tools

| Tool | Description | |------|-------------| | get_env | Get .env file contents | | update_env | Update .env file |

SSL Tools

| Tool | Description | |------|-------------| | get_ssl_certificates | List SSL certificates | | obtain_letsencrypt_cert | Get Let's Encrypt certificate | | activate_ssl_certificate | Activate a certificate |

Nginx Tools

| Tool | Description | |------|-------------| | get_nginx_config | Get Nginx configuration | | update_nginx_config | Update Nginx configuration |

Database Tools

| Tool | Description | |------|-------------| | list_databases | List all databases | | create_database | Create a database | | delete_database | Delete a database |

Worker Tools

| Tool | Description | |------|-------------| | list_workers | List queue workers | | create_worker | Create a queue worker | | delete_worker | Delete a worker | | restart_worker | Restart a worker |

Scheduled Job Tools

| Tool | Description | |------|-------------| | list_scheduled_jobs | List cron jobs | | create_scheduled_job | Create a cron job | | delete_scheduled_job | Delete a cron job |

Daemon Tools

| Tool | Description | |------|-------------| | list_daemons | List daemons | | create_daemon | Create a daemon | | delete_daemon | Delete a daemon | | restart_daemon | Restart a daemon |

PHP Tools

| Tool | Description | |------|-------------| | list_php_versions | List installed PHP versions |

Example: Deploy a Laravel App with Horizon

# 1. Create site
create_site: domain=myapp.com, projectType=php, serverId=123

# 2. Install Git repo
install_git_repository: provider=github, repository=user/repo, branch=main, composer=true

# 3. Set up environment
update_env: content="APP_ENV=production\n..."

# 4. Get SSL certificate
obtain_letsencrypt_cert: domains=["myapp.com", "www.myapp.com"]

# 5. Create Horizon daemon
create_daemon: command="php /home/forge/myapp.com/artisan horizon", user=forge

# 6. Create scheduler cron
create_scheduled_job: command="php /home/forge/myapp.com/artisan schedule:run", frequency="* * * * *", user=forge

# 7. Deploy
deploy_site: serverId=123, siteId=456

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Credits

• Original author: @bretterer
• Extended by: OBS Technologies