Servidor MCP de Forge

Se trata de un servidor MCP (Model Context Protocol) para la integración de Laravel Forge. Proporciona un acceso completo a la API oficial de Laravel Forge a través de herramientas compatibles con MCP, permitiendo una gestión del servidor y del sitio sin fisuras.

Para obtener más información acerca de la API de Laravel Forge, consulte la documentación oficial de la API.

Características

• Servidor compatible con MCP
• Integración completa de la API Laravel Forge
• Herramienta de comprobación de estado: test_connection
• Amplia cobertura de herramientas para la gestión del servidor y del sitio
• Construido sobre la API oficial de Laravel Forge

Requisitos previos

• Node.js (v18+ recomendado)
• npm (v9+ recomendado)

Configuración y uso

Se requiere una clave API de Forge para todas las invocaciones a la herramienta Forge. Debe proporcionarla como

• la variable de entorno FORGE_API_KEY, o bien
• el argumento de línea de comandos --api-key

Uso con Claude Desktop

Añada lo siguiente a su claude_desktop_config.json. Vea aquí para más detalles.

Opción 1: Usando npx (Recomendado)

Usando la variable de entorno

{ "mcpServers": { "forge-mcp": { "command": "npx", "args": [ "-y", "@ranium/forge-mcp" ], "env": { "FORGE_API_KEY": "your_forge_api_key_here" } } }

Usando argumento de línea de comandos:

{ "mcpServers": { "forge-mcp": { "command": "npx", "args": [ "-y", "@ranium/forge-mcp", "--api-key=su_clave_forge_api_here" ] } }

Opción 2: Usar node directamente

Primero, clona el repositorio y construye el proyecto:

git clone https://github.com/ranium/forge-mcp-server cd forge_mcp npm install npm run build

Luego añade lo siguiente a tu claude_desktop_config.json:

Usando variable de entorno:

{ "mcpServers": { "forge-mcp": { "command": "node", "args": [ "/path/to/forge_mcp/dist/server.js" ], "env": { "FORGE_API_KEY": "your_forge_api_key_here" } } }

Usando argumento de línea de comandos:

{ "mcpServers": { "forge-mcp": { "command": "node", "args": [ "/ruta/a/forge_mcp/dist/servidor.js", "--api-key=tu_clave_de_forge_api_aquí" ] } }

Nota: Puede utilizar la variable de entorno FORGE_API_KEY o el argumento --api-key. Si se proporcionan ambos, el argumento de la línea de comandos tiene prioridad. Nunca envíe sus claves de API reales al control de versiones. Utilice variables de entorno o gestión de secretos en producción.

Categorías de herramientas y control de acceso

Todas las herramientas se agrupan en dos categorías:

• Sólo lectura: Operaciones seguras y no modificables (por ejemplo, listado, visualización, comprobaciones de estado).
• Escritura: Operaciones que crean o modifican recursos (por ejemplo, crear, actualizar, reiniciar, activar/desactivar funciones).

Por defecto, sólo están habilitadas las herramientas de sólo lectura. Para habilitar las herramientas de escritura, utilice el indicador --tools:

• --tools=sólo lectura (por defecto)
• --tools=readonly,write (activa las herramientas de sólo lectura y escritura)

Ejemplo:

npx -y @ranium/forge-mcp --api-key=tu_clave_forge_api_aquí --tools=sólo_lectura,escritura

O en claude_desktop_config.json:

{ "mcpServers": { "forge-mcp": { "command": "npx", "args": [ "-y", "@ranium/forge-mcp", "--api-key=su_clave_forge_api_here", "--tools=readonly,write" ] } }

Herramientas disponibles (por categoría)

Herramientas de sólo lectura

• list_servers - Lista todos los servidores
• list_static_php_versions - Lista las versiones estáticas de PHP
• list_php_versions - Lista las versiones de PHP
• get_user - Obtener información del usuario
• show_server - Obtener información detallada sobre un servidor específico
• list_sites - Lista todos los sitios de un servidor
• show_site - Obtener información detallada sobre un sitio específico
• list_daemons - Listar demonios
• show_daemon - Obtener información detallada sobre demonios
• list_deployments - Listar despliegues
• get_deployment_log - Obtener registros de despliegue
• get_deployment - Obtener detalles de la implantación
• get_deployment_output - Obtener la salida de la implantación
• get_server_logs - Obtener los registros del servidor
• list_providers - Listar proveedores de nube
• list_database_types - Listar tipos de bases de datos
• list_credentials - Lista de credenciales
• list_regions - Lista las regiones disponibles
• list_ubuntu_versions - Lista las versiones de Ubuntu
• get_composer_packages_auth - Obtener autenticación de Composer
• check_laravel_maintenance_status - Comprueba el modo de mantenimiento de Laravel
• check_pulse_daemon_status - Comprueba el estado del demonio Pulse
• check_inertia_daemon_status - Comprueba el estado del demonio Inertia
• check_laravel_scheduler_status - Comprueba el estado del programador de Laravel
• list_sizes - Lista de tamaños de servidor
• list_project_types - Lista de tipos de proyectos
• list_databases - Lista todas las bases de datos
• get_database - Obtener detalles de la base de datos
• list_database_users - Lista los usuarios de la base de datos
• get_database_user - Obtener detalles del usuario de la base de datos
• list_certificates - Listar certificados SSL
• get_certificate - Obtener detalles del certificado
• get_site_env - Obtener el archivo de entorno del sitio (.env)
• get_site_log - Obtener los registros del sitio

Herramientas de escritura

• create_server - Crear un nuevo servidor
• create_database - Crear una nueva base de datos
• sync_database - Sincronizar base de datos
• create_database_user - Crear un nuevo usuario de base de datos
• reboot_server - Reiniciar un servidor
• reboot_nginx - Reinicia el servicio Nginx
• reboot_php - Reinicia el servicio PHP
• reboot_mysql - Reinicia el servicio MySQL
• reboot_postgres - Reinicia el servicio PostgreSQL
• create_site - Crear un nuevo sitio
• install_or_update_site_git - Instalar o actualizar el repositorio Git
• enable_quick_deployment - Habilitar despliegue rápido
• disable_quick_deployment - Desactivar el despliegue rápido
• deploy_now - Desplegar inmediatamente
• change_site_php_version - Cambiar la versión PHP del sitio
• add_site_aliases - Añadir alias de sitio
• clear_site_log - Borrar los registros del sitio
• create_lets_encrypt_certificate - Crear certificado Let's Encrypt
• activate_certificate - Activar un certificado

Capturas de pantalla

Creación de un servidor

Demuestra el proceso de creación de un servidor a través de la interfaz MCP

Crear un Sitio

Muestra cómo crear un nuevo sitio en un servidor existente

Reiniciar un Servidor

Ilustra la funcionalidad de reinicio del servidor

Estructura del Proyecto

• src/server.ts - Punto de entrada principal del servidor MCP
• src/tools/forge/ - Todas las definiciones de herramientas Forge y registro
• src/core/types/ - Definiciones de tipos y protocolos
• package.json - Scripts y dependencias
• .gitignore - Ignora archivos de compilación, entorno y dependencias

Ampliación (adición de nuevas herramientas)

1. Exporte una ForgeToolDefinition del nuevo archivo.
2. Importe y añada la herramienta a la matriz forgeTools en src/tools/forge/index.ts.
3. Las herramientas se registrarán cuando se inicie el servidor.

Para más información sobre MCP, consulte la documentación del Protocolo de Contexto de Modelo.

Descargo de responsabilidad

El servidor MCP de Forge es un producto independiente y no está oficialmente afiliado, respaldado o patrocinado por Laravel o Taylor Otwell. laravel' es una marca registrada propiedad de Taylor Otwell. Forge MCP server es desarrollado y mantenido independientemente del proyecto oficial Laravel.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.