Servidor MCP de Coolify
Una implementación de servidor de Protocolo de contexto de modelo (MCP) para Coolify , que permite a los asistentes de IA interactuar con sus instancias de Coolify a través del lenguaje natural.
Ejemplos de indicaciones
A continuación se muestran ejemplos de indicaciones que puede utilizar con asistentes de IA compatibles con MCP para interactuar con su instancia de Coolify:
Administración de servidores
# List and Inspect Servers
- Show me all Coolify servers in my instance
- What's the status of server {uuid}?
- Show me the resources running on server {uuid}
- What domains are configured for server {uuid}?
- Can you validate the connection to server {uuid}?
# Resource Monitoring
- How much CPU and memory is server {uuid} using?
- List all resources running on server {uuid}
- Show me the current status of all servers
Gestión de proyectos
# Project Operations
- List all my Coolify projects
- Create a new project called "my-webapp" with description "My web application"
- Show me the details of project {uuid}
- Update project {uuid} to change its name to "new-name"
- Delete project {uuid}
# Environment Management
- Show me the environments in project {uuid}
- Get details of the production environment in project {uuid}
- What variables are set in the staging environment of project {uuid}?
Gestión de aplicaciones y servicios
# Application Management
- List all applications
- Show me details of application {uuid}
- Create a new application called "my-nodejs-app"
- Delete application {uuid}
# Service Operations
- Show me all running services
- Create a new WordPress service:
- Name: my-blog
- Project UUID: {project_uuid}
- Server UUID: {server_uuid}
- Type: wordpress-with-mysql
- What's the status of service {uuid}?
- Delete service {uuid} and clean up its resources
Gestión de bases de datos
# Database Operations
- List all databases
- Show me the configuration of database {uuid}
- Update database {uuid}:
- Increase memory limit to 1GB
- Change public port to 5432
- Update password
- Delete database {uuid} and clean up volumes
# Database Types
- Create a PostgreSQL database
- Set up a Redis instance
- Configure a MongoDB database
- Initialize a MySQL database
Gestión de la implementación
# Deployment Operations
- Show me all active deployments
- What's the status of deployment {uuid}?
- Deploy application {uuid}
- Force rebuild and deploy application {uuid}
- List recent deployments for application {uuid}
Instalación
Prerrequisitos
- Node.js >= 18
- Una instancia de Coolify en ejecución
- Token de acceso a la API de Coolify
Configuración en herramientas de IA
Escritorio de Claude
"coolify": {
"command": "npx",
"args": [
"-y", "@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "0|your-secret-token",
"COOLIFY_BASE_URL": "https://your-coolify-instance.com"
}
}
Cursor
env COOLIFY_ACCESS_TOKEN:0|your-secret-token COOLIFY_BASE_URL:https://your-coolify-instance.com npx -y @stumason/coolify-mcp
Desarrollo
Configuración local
# Clone the repository
git clone https://github.com/stumason/coolify-mcp.git
cd coolify-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run tests
npm test
Variables de entorno
# Required
COOLIFY_ACCESS_TOKEN=your_access_token_here
# Optional (defaults to http://localhost:3000)
COOLIFY_BASE_URL=https://your.coolify.instance
Referencia de API
Tipos de recursos
Solicitud
interface Application {
uuid: string;
name: string;
// Additional properties based on your Coolify instance
}
Servicio
interface Service {
id: number;
uuid: string;
name: string;
type: ServiceType; // Various types like 'wordpress', 'mysql', etc.
status: 'running' | 'stopped' | 'error';
project_uuid: string;
environment_uuid: string;
server_uuid: string;
domains?: string[];
}
Base de datos
interface Database {
id: number;
uuid: string;
name: string;
type: 'postgresql' | 'mysql' | 'mongodb' | 'redis' | /* other types */;
status: 'running' | 'stopped' | 'error';
is_public: boolean;
public_port?: number;
// Additional configuration based on database type
}
Despliegue
interface Deployment {
id: number;
uuid: string;
application_uuid: string;
status: string;
created_at: string;
updated_at: string;
}
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Apoyo
Para obtener ayuda, por favor:
- Consulte la página de problemas
- Crea un nuevo problema si es necesario
- Únete a la comunidad Coolify