forge-mcp-server

bretterer/forge-mcp-server

3.4

If you are the rightful owner of forge-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for interacting with Laravel Forge API, enabling AI assistants to manage Laravel Forge servers, sites, and deployments.

Laravel Forge MCP Server

A Model Context Protocol (MCP) server for interacting with Laravel Forge API. This server enables AI assistants to manage Laravel Forge servers, sites, and deployments.

Features

  • List and get details of Laravel Forge servers
  • Manage sites on Laravel Forge servers
  • Deploy sites and manage deployment scripts
  • Toggle quick deploy functionality
  • View deployment history
  • Reboot servers and check server load

Installation

npm install @bretterer/forge-mcp-server

Usage

Prerequisites

You need a Laravel Forge API key to use this server. You can get one from your Laravel Forge account settings.

Environment Variables

Set your Laravel Forge API key as an environment variable:

export FORGE_API_KEY=your_forge_api_key

Running the Server

npx forge-mcp-server

Or add it to your project:

import { ForgeServer } from '@bretterer/forge-mcp-server';

const server = new ForgeServer();
server.run().catch(console.error);

Available Tools

The MCP server provides the following tools:

  • list_servers - List all Laravel Forge servers
  • get_server - Get details of a specific server
  • list_sites - List all sites on a server
  • get_site - Get details of a specific site
  • deploy_site - Deploy a site
  • get_deployments - Get deployment history for a site
  • get_deployment_script - Get the deployment script for a site
  • update_deployment_script - Update the deployment script for a site
  • toggle_quick_deploy - Enable or disable quick deploy for a site
  • reboot_server - Reboot a server
  • get_server_load - Get server load metrics
  • reset_deployment_state - Reset deployment state for a site

Development

Setup

git clone https://github.com/bretterer/forge-mcp-server.git
cd forge-mcp-server
npm install

Build

npm run build

Run in Development Mode

npm run dev

License

MIT

Contributing

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