freqkflag/coolify-mcp-server repository overview

Coolify MCP Server is a lightweight, self-hosted Model Context Protocol (MCP) adapter built for seamless integration with Coolify deployments. It provides a plug-and-play way to connect your local or cloud-hosted AI models, developer agents, or LLM services into your Coolify environment for automated orchestration, context sharing, and runtime extensions.

🚀 Features

Zero-config setup: Works out of the box with Coolify and other MCP-compliant clients (Cursor, OpenWebUI, MetaMCP, etc.).

Container-ready: Optimized for Docker Compose, Coolify, or standalone deployments.

Secure by design: Environment variables, authentication, and context isolation supported.

Extensible: Add custom tools, AI agents, or context adapters via /app/extensions.

🧩 Quick Start

⁠1. Pull the image

docker pull freqkflag/coolify-mcp-server:latest

⁠2. Run it (example with env vars)

docker run -d
--name coolify-mcp-server
-p 3000:3000
-e MCP_API_KEY=yourapikey
-e COOLIFY_URL=https://yourcoolify.domain⁠
freqkflag/coolify-mcp-server:latest

Access the MCP endpoint at: http://localhost:3000/api⁠

⚙️ Environment Variables Variable Description MCP_API_KEY API key for authenticating with MCP clients COOLIFY_URL Base URL of your Coolify instance MODEL_PROVIDER (optional) Provider name (e.g., localai, openrouter, etc.) LOG_LEVEL (optional) Log verbosity, e.g., info, debug 🔧 Example Docker Compose version: "3.9" services: coolify-mcp-server: image: freqkflag/coolify-mcp-server:latest container_name: coolify-mcp-server restart: unless-stopped ports: - "3000:3000" environment: - MCP_API_KEY=${MCP_API_KEY} - COOLIFY_URL=https://vps.freqkflag.co⁠

🌐 Integration Notes

This image is compatible with:

Coolify (auto-discovery in MCP integration panel)

MetaMCP / FastMCP

Cursor + VS Code MCP

LocalAI, OpenWebUI, Ollama backends

🧑‍💻 Maintainer

Joey King – freqkflag.co

📦 Docker: freqkflag/coolify-mcp-server 💻 GitHub: freqkflag/coolify-mcp-server

🧪 Tags

latest, 1.0.0, 1.0, 1

🕯️ License

MIT — Use freely, contribute boldly, and host locally.