coolify-mcp-server

@kof70/coolify-mcp-server

0 Stars 185 次浏览 kof70 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

服务介绍

Coolify MCP Server

A Model Context Protocol (MCP) server for Coolify API integration. Control your self-hosted PaaS directly from Claude, Kiro, or any MCP-compatible AI assistant.

Features

Complete API Coverage: Applications, Databases, Servers, Projects, Services, Teams, Deployments, Private Keys
MCP Resources: Direct resource access via coolify:// URIs
Version Detection: Automatic feature compatibility based on Coolify version
Rate Limiting: Built-in rate limit handling with retry logic
Minimal Dependencies: Only axios and MCP SDK
TypeScript: Full type safety

Installation

From npm (recommended)

npm install -g coolify-mcp-server

From source

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

Configuration

Environment Variables

Variable	Required	Description
`COOLIFY_BASE_URL`	Yes	Your Coolify instance URL (e.g., `https://coolify.example.com`)
`COOLIFY_TOKEN`	Yes	API token from Coolify
`COOLIFY_TEAM_ID`	No	Team ID for multi-team setups

Getting an API Token

Go to your Coolify instance
Navigate to Keys & Tokens API tokens
Create a new token with required permissions:
- read - For listing resources
- write - For creating/updating resources
- deploy - For deployment operations

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

With Kiro

Add to your .kiro/settings/mcp.json:

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

From Source

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp-server/build/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Version & Health

Tool	Description
`get_version`	Get Coolify version information
`health_check`	Check API health status

Teams

Tool	Description
`list_teams`	List all accessible teams
`get_team`	Get team details by ID
`get_current_team`	Get current team details
`get_current_team_members`	Get current team members

Servers

Tool	Description
`list_servers`	List all servers
`create_server`	Create a new server
`validate_server`	Validate server connection
`get_server_resources`	Get server resource usage
`get_server_domains`	Get server domains

Projects & Environments

Tool	Description
`list_projects`	List all projects
`get_project`	Get project details
`create_project`	Create a new project
`list_environments`	List project environments
`create_environment`	Create a new environment

Applications

Tool	Description
`list_applications`	List all applications
`get_application`	Get application details
`create_application`	Create a new application
`start_application`	Start an application
`stop_application`	Stop an application
`restart_application`	Restart an application
`deploy_application`	Deploy an application
`execute_command`	Execute command in container
`get_application_logs`	Get application logs

Services

Tool	Description
`list_services`	List all services
`create_service`	Create a new service
`start_service`	Start a service
`stop_service`	Stop a service
`restart_service`	Restart a service

Databases

Tool	Description
`list_databases`	List all databases
`create_database`	Create a new database (PostgreSQL, MySQL, MongoDB, Redis)

Deployments

Tool	Description
`list_deployments`	List all deployments
`get_deployment`	Get deployment details

Private Keys

Tool	Description
`list_private_keys`	List all SSH private keys
`create_private_key`	Create a new SSH private key

MCP Resources

Access data directly via MCP resources:

coolify://applications    - List all applications
coolify://databases       - List all databases
coolify://servers         - List all servers
coolify://projects        - List all projects
coolify://services        - List all services
coolify://teams           - List all teams
coolify://deployments     - List all deployments
coolify://private-keys    - List all private keys

Example Prompts

Once configured, you can ask your AI assistant:

"List all my Coolify applications"
"Deploy the app with UUID abc123"
"Show me the logs for my-app"
"Create a new PostgreSQL database called mydb"
"What servers do I have in Coolify?"
"Restart the production application"

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Coolify - The amazing self-hosted PaaS
Model Context Protocol - The MCP specification
All contributors who help improve this project

Support

查看源码项目主页