Coolify MCP Server

What is coolify-mcp-server

coolify-mcp-server is an integration layer designed to facilitate seamless interactions with various resources and applications through the Coolify API. Developed by StuMason, this server operates as part of the Model Context Protocol (MCP), a universal standard that enables AI systems to securely connect with external data sources. Built using TypeScript, coolify-mcp-server leverages the MCP SDK to ensure smooth communication and integration. Although still in development, this server offers a standardized interface for managing applications and resources effectively.

How to Use coolify-mcp-server

To get started with coolify-mcp-server, you will need to set it up by following a few straightforward steps:

1. Clone the Repository: Begin by cloning the coolify-mcp-server repository to your local machine.

   git clone <repository-url>
   cd coolify-mcp
   

2. Install Dependencies: Navigate to the cloned directory and install the necessary dependencies using npm.

   npm install
   

   After installation, build the server to prepare it for execution:

   npm build
   

3. Configure the Server: You will need to configure the server by editing the claude_desktop_config.json file to include the necessary environment variables and server paths.

   "mcpServers": {
       "coolify": {
           "command": "node",
           "args": [
               "/full/path/to/mcp-coolify/build/index.js"
           ],
           "env": {
               "COOLIFY_ACCESS_TOKEN": "coolify_api_key",
               "COOLIFY_BASE_URL": "https://your-coolify-url.co.uk"
           }
       }
   }
   

Once set up, the server can be utilized through various API endpoints to manage and interact with your applications.

Key Features of coolify-mcp-server

coolify-mcp-server offers a suite of features designed to streamline the management of applications and resources:

• List Resources and Applications: Easily access a comprehensive list of all resources and applications within Coolify.

• Application Management: Start, stop, and restart applications using simple API requests, allowing for efficient application lifecycle management.

• Deployment: Deploy applications by specifying a tag or UUID, ensuring streamlined and organized deployment processes.

• Health and Version Checks: Perform system health checks and fetch the current version of the Coolify API to maintain an overview of system status and updates.

• Detailed Information Retrieval: Fetch detailed information about specific applications, enabling informed decision-making and management.

These features make coolify-mcp-server a robust tool for developers and administrators looking to integrate and manage applications through a standardized protocol. Whether you're deploying new applications or maintaining existing ones, coolify-mcp-server provides the necessary tools for effective management and integration.