FusionAL

🚀 FusionAL — Puerta de enlace de gobernanza MCP autoalojada

Tu equipo conectó 10 servidores MCP. ¿Y ahora qué?
🌐 fusional.dev • 📧 jrm@fusional.com • 🗓️ Reserva una llamada

MCP es potente. El despliegue empresarial de MCP es un problema completamente distinto.

Cada servidor que conectas carga su manifiesto completo de herramientas en la ventana de contexto de Claude antes de procesar un solo token de tu solicitud. Con 84 herramientas distribuidas en varios servidores, eso son 15,540 tokens consumidos al inicio de la sesión — antes de que tu equipo haya preguntado nada. A escala, eso es costo, latencia y una superficie de auditoría que nadie puede explicar a legal.

FusionAL es una puerta de enlace de gobernanza MCP autoalojada que se sitúa entre tus clientes de IA y tus servidores de herramientas. Un solo endpoint. Autenticación central. Aplicación de políticas a nivel de herramienta. Registro de auditoría completo. Desplegable con un solo comando de Docker — incluso en Windows, donde MCP tiene 6 modos de fallo documentados que la documentación oficial no cubre.

Diseñado para equipos que ya han dicho sí a MCP y ahora necesitan ejecutarlo de forma segura:

• Control de tokens — filtra la exposición de herramientas por cliente para que la inflación del contexto no escale con el número de servidores
• Operaciones listas para auditoría — cada llamada a herramienta se registra con llamador, entrada, latencia y estado de respuesta
• Aplicación de políticas — controla qué herramientas se ejecutan, para quién y bajo qué condiciones
• Reforzado para Windows — 6 modos de fallo documentados resueltos, ninguno de los cuales aparece en la documentación oficial de MCP
• Generación de servidores impulsada por IA — describe una herramienta en inglés sencillo, FusionAL la crea y la registra
• Opción llave en mano — nosotros lo desplegamos, gobernamos y gestionamos por ti

La pregunta no es si adoptar MCP. Es si tu despliegue sobrevivirá al contacto con tu equipo de seguridad.

---

⚡ Inicio rápido (5 minutos)

Requisitos previos

• Docker Desktop (instalado y en ejecución)
• Claude Desktop
• Python 3.11+
• Git

Paso 1: Clonar e instalar

git clone https://github.com/JRM-FusionAL/FusionAL.git
cd FusionAL

python -m venv venv
source venv/bin/activate        # macOS/Linux
# venv\Scripts\activate         # Windows

pip install -r core/requirements.txt

Paso 2: Iniciar FusionAL

cd core
python -m uvicorn main:app --reload --port 8009

Verifica que está en ejecución:

curl http://localhost:8009/health

Paso 3: Configurar Claude Desktop

Encuentra tu archivo de configuración:

• Windows: C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

⚠️ Usuarios de Windows: NO uses %APPDATA% en la ruta — Claude Desktop no lo expandirá. Escribe la ruta completa. Ejemplo: C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json

Añade FusionAL como servidor MCP:

{
  "mcpServers": {
    "fusional-gateway": {
      "url": "http://localhost:8009/sse"
    }
  }
}

Paso 4: Reiniciar Claude Desktop y probar

Sal por completo y vuelve a abrir Claude Desktop. Abre un nuevo chat y prueba:

"Genera un servidor MCP en Python que obtenga el clima actual para una ciudad determinada."

FusionAL lo generará, registrará y ejecutará automáticamente.

---

🐳 Despliegue con Docker

Compila y ejecuta la puerta de enlace completa en Docker:

docker build -t fusional .
docker run -d -p 8089:8009 --name fusional fusional

O con Docker Compose:

docker compose up -d

Puerta de enlace disponible en http://localhost:8089.

---

🏗️ Arquitectura

Claude Desktop / Any MCP Client
         │
         ▼  (SSE or Streamable HTTP)
  FusionAL Gateway  (:8009)
         │
   ┌─────┴──────┐
   ▼            ▼
FastAPI      MCP Transport (/mcp)
REST API     ├── execute_code
             ├── generate_and_execute
             └── generate_mcp_project
         │
         ▼
  Docker Sandbox Executor
  (network isolated, memory capped)
         │
         ▼
  MCP Server Registry (JSON)
  ├── business-intelligence-mcp  (:8101)
  ├── api-integration-hub        (:8102)
  └── content-automation-mcp     (:8103)

Herramientas MCP (a través de /mcp)

Herramienta	Descripción
execute_code	Ejecuta Python en un sandbox de subproceso aislado
generate_and_execute	Indicación en inglés sencillo → Claude la escribe → la ejecuta
generate_mcp_project	Describe un servidor MCP → Claude construye el proyecto completo

API REST

Endpoint	Método	Descripción
/health	GET	Verificación de estado
/execute	POST	Ejecuta Python (sandbox Docker opcional)
/register	POST	Registra un servidor MCP en el registro
/catalog	GET	Lista todos los servidores registrados
/generate	POST	Genera y lanza un nuevo servidor a partir de una indicación

---

🛠️ Servidores de demostración

Estos servidores se incluyen con el mcp-consulting-kit y están pre-registrados en la puerta de enlace FusionAL:

Servidor	Puerto	Herramientas
business-intelligence-mcp	8101	Lenguaje natural → SQL (PostgreSQL, MySQL, SQLite)
api-integration-hub	8102	Slack, GitHub Issues, búsqueda de clientes en Stripe
content-automation-mcp	8103	Raspado web, extracción de enlaces, análisis de tablas, fuentes RSS

Inicia la pila de demostración completa:

cd ../mcp-consulting-kit
docker compose up -d

---

🔒 Modelo de seguridad

Sandbox Docker

Cada ejecución de código se ejecuta con:

• ✅ Aislamiento de red (--network none)
• ✅ Límites de memoria (128 MB por defecto, configurable)
• ✅ Límites de procesos (máximo 64 procesos)
• ✅ Sistema de archivos de solo lectura (excepto /tmp)
• ✅ Sin escalada de privilegios
• ✅ Ejecución con usuario no root

Seguridad de API (opcional)

Cuando mcp-consulting-kit/showcase-servers/common/security.py está presente, la puerta de enlace habilita:

• Autenticación con clave de API en /execute, /register, /generate
• Limitación de velocidad
• Configuración de CORS

---

🪟 Correcciones específicas para Windows

FusionAL documenta y resuelve 6 modos de fallo de MCP en Windows no cubiertos en la documentación oficial:

1. El silencio de 60 segundos — Claude Desktop agota el tiempo de espera sin ningún error. Causado por el retraso de inicialización del socket de Docker.
   Lee la corrección →

2. La trampa del BOM — Notepad/VS Code inyecta una marca de orden de bytes en los JSON de configuración, rompiendo MCP silenciosamente.
   Corrección: [System.IO.File]::WriteAllText(path, content, New-Object System.Text.UTF8Encoding($false))

3. La trampa de la barra invertida — Los separadores de ruta de Windows en claude_desktop_config.json rompen el inicio silenciosamente.
   Usa barras normales o barras invertidas dobles escapadas.

4. Expansión de %USERPROFILE% — Claude Desktop NO expande variables de entorno en rutas de configuración. Escríbelas completas.

5. Fallo de la tubería con nombre de Docker — El transporte de tubería con nombre de Docker falla en WSL2. Usa /var/run/docker.sock.

6. Tiempo de espera del registro con 8+ servidores — Claude Desktop alcanza un umbral de tiempo de espera en hardware de gama baja.
   Limita tu registro a 8 servidores en i5/i7 de 7.ª generación o inferior.

---

🧰 Cómo crear tu propio servidor MCP

Usando el constructor de IA (a través de Claude Desktop)

Después de conectar FusionAL, pídele a Claude:

"Genera un servidor MCP que consulte nuestra base de datos PostgreSQL usando lenguaje natural."

FusionAL genera el proyecto completo, lo compila y lo registra en la puerta de enlace automáticamente.

Estructura manual del servidor

my-server/
├── Dockerfile
├── requirements.txt
├── my_server.py       ← FastMCP tools go here
└── .env

Reglas clave

1. Usa decoradores @mcp.tool() en funciones asíncronas
2. Solo cadenas de documentación de una línea (las de varias líneas rompen algunos clientes MCP)
3. Devuelve cadenas formateadas desde todas las herramientas
4. Parámetros por defecto a "" no a None
5. Registra en sys.stderr
6. Ejecuta como no root en Docker

from mcp.server.fastmcp import FastMCP
import sys

mcp = FastMCP("my-server")

@mcp.tool()
async def my_tool(query: str = "") -> str:
    """What this tool does in one line."""
    return f"✅ Result for: {query}"

if __name__ == "__main__":
    mcp.run(transport='stdio')

---

📚 Ejemplos

Ejemplo	Ruta	Qué demuestra
Lanzador de dados	examples/dice-roller/	Dados de D&D (8 herramientas), análisis de notación de dados
API del clima	examples/weather-api/	Integración con API externa, manejo de errores
Utilidades de archivos	examples/file-utils/	Acceso seguro al sistema de archivos, paginación

---

🚀 Consultoría llave en mano

¿No quieres gestionarlo tú mismo? FusionAL ofrece despliegues MCP llave en mano:

Nivel	Alcance	Precio
Instalación inicial	Entorno único, servidores principales, refuerzo para Windows	$2,500–$3,500
Instalación completa	Pila completa, servidores personalizados, capa de gobernanza, incorporación del equipo	$5,000–$9,000
Retainer	Operaciones continuas, respuesta a incidentes, creación de nuevos servidores	$1,500–$4,000/mes

Reserva una auditoría gratuita de seguridad MCP de 15 minutos →

---

🤝 Contribuciones

Las contribuciones son bienvenidas. Áreas prioritarias:

• Nuevos servidores de ejemplo
• Correcciones de compatibilidad con Windows
• Mejoras de documentación
• Cobertura de pruebas

---

📄 Licencia

MIT — consulta LICENSE

---

🙏 Créditos

• Anthropic — Claude AI + protocolo MCP
• FastAPI — Framework de API
• FastMCP — Framework de servidores MCP
• Docker — Infraestructura de contenedores

---

Construido por un desarrollador autodidacta que corrigió los problemas de MCP que nadie más documentó.
🌐 fusional.dev • ⭐ Marca el repositorio con una estrella si te ahorró horas

---

🙌 Origen e inspiración

FusionAL comenzó con un video de NetworkChuck.

Si no has visto "you need to learn MCP RIGHT NOW!!" — ve a verlo primero. Chuck explica los fundamentos mejor que nadie, y su repositorio docker-mcp-tutorial es el mejor punto de partida para entender cómo funcionan los servidores MCP con Docker.

El ejemplo del lanzador de dados y la estructura de inicio rápido en este repositorio están adaptados de ese tutorial (licencia MIT).

Dónde va más allá FusionAL:

El tutorial de Chuck te muestra cómo crear servidores MCP manualmente — edita una plantilla de indicación, pégala en Claude, implementa el resultado tú mismo.

FusionAL elimina al humano de ese bucle por completo. En lugar de un archivo de indicación que copias y pegas, generate_mcp_project es una llamada a herramienta en vivo — Claude describe lo que quiere construir, FusionAL lo genera, lo registra y lo ejecuta. Sin portapapeles. Sin pasos manuales.

Más importante aún, el video de Chuck cubre el catálogo MCP de Docker — más de 300 servidores que puedes habilitar con un clic. Eso es el paso uno. FusionAL es lo que necesitas cuando un CTO pregunta:

"Genial — pero ¿cómo auditamos lo que hacen esas herramientas? ¿Cómo aplicamos políticas? ¿Cómo nos aseguramos de que esto no se convierta en un incidente de seguridad?"

Ese es el vacío que FusionAL fue construido para llenar: gobernanza, auditabilidad y control operativo para equipos que despliegan MCP a escala — especialmente en Windows, donde el catálogo por sí solo no es suficiente.