Flame MCP Server

Proporciona documentación en vivo y actualizada para el motor de juegos Flame.

Documentación

Servidor Flame MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso integral a la documentación del motor de juegos Flame para asistentes de IA como Claude Desktop y Amazon Q Developer.

🎯 Qué Hace Esto

Architecture Diagram

Acceso a Documentación: Proporciona acceso buscable a la documentación completa del motor Flame
Sistema de Tutoriales: Ofrece tutoriales de desarrollo de juegos paso a paso (Space Shooter, Platformer, Klondike)
Caché Local: Almacena documentación localmente para acceso rápido y sin conexión
Integración MCP: Funciona perfectamente con Claude Desktop y Amazon Q CLI
Herramientas de Búsqueda: Búsqueda inteligente en toda la documentación y tutoriales

🚀 Inicio Rápido

1. Compilar y Configurar

# Clone and build the server
git clone <repository-url>
cd flame_mcp_server
./build_clean.sh

Esto:

Instalará las dependencias de Dart
Compilará el ejecutable del servidor MCP
Descargará y almacenará en caché toda la documentación de Flame (~146 archivos)

2. Configurar Tu Cliente MCP

Amazon Q Developer

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "flame-docs": {
      "command": "/absolute/path/to/flame_mcp_server/build/flame_mcp_live"
    }
  }
}

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "flame-docs": {
      "command": "/absolute/path/to/flame_mcp_server/build/flame_mcp_live"
    }
  }
}

Ubicaciones de archivos de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

3. Reinicia Tu Cliente MCP

Reinicia Claude Desktop o Amazon Q CLI para cargar el servidor de documentación de Flame.

🛠️ Herramientas Disponibles

`search_documentation`

Busca en toda la documentación de Flame temas específicos.

Ejemplos de consultas:

"¿Cómo implemento la detección de colisiones en Flame?"
"Busca ejemplos del sistema de componentes"
"Encuentra información sobre animaciones de sprites"

`tutorial`

Obtén tutoriales completos de desarrollo de juegos paso a paso.

Tutoriales disponibles:

Space Shooter: Tutorial completo de 6 pasos para crear un shooter espacial clásico
Platformer: Tutorial de 7 pasos para crear un plataformas de desplazamiento lateral (Ember Quest)
Klondike: Tutorial de 5 pasos para crear un juego de cartas solitario

Ejemplos de uso:

"Muéstrame cómo crear un juego de shooter espacial" → Tutorial completo con todos los pasos
"Quiero crear un juego de plataformas" → Tutorial completo de plataformas
"Lista todos los tutoriales disponibles" → Resumen de todos los tutoriales

📊 Arquitectura

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │    │  Flame MCP       │    │  Documentation  │
│ (Claude/Amazon Q)│◄──►│     Server       │◄──►│     Cache       │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │   GitHub API     │
                       │ (flame-engine/   │
                       │    flame/doc)    │
                       └──────────────────┘

🔧 Configuración

Token de GitHub (Recomendado)

Para mejores límites de tasa (5,000 vs 60 solicitudes/hora):

Crea un Token de Acceso Personal de GitHub:
- Ve a Configuración de GitHub → Configuración de desarrollador → Tokens de acceso personal
- Genera un nuevo token con el alcance public_repo

Establece la variable de entorno:

# macOS/Linux
export GITHUB_TOKEN=your_token_here

# Windows
setx GITHUB_TOKEN "your_token_here"

📁 Estructura del Proyecto

flame_mcp_server/
├── bin/
│   ├── flame_mcp_live.dart           # Main MCP server
│   └── flame_sync_standalone.dart    # Documentation sync utility
├── lib/src/
│   ├── flame_live_docs.dart          # Documentation management
│   └── flame_mcp_live.dart           # MCP protocol implementation
├── build/
│   └── flame_mcp_live                # Compiled MCP server
├── flame_docs_cache/                 # Cached documentation (146 files)
├── build_clean.sh                    # Build and setup script
└── README.md                         # This file

🎮 Ejemplos de Interacciones

Creando un Juego de Shooter Espacial

Tú: "Quiero crear un juego de shooter espacial en Flame. Muéstrame el tutorial completo."

Respuesta: Tutorial completo de 6 pasos que incluye:

Configuración del proyecto y estructura básica del juego
Controles del jugador y gráficos
Animaciones y efectos visuales
Generación y movimiento de enemigos
Mecánicas de disparo
Detección de colisiones y puntuación

Aprendiendo Sobre Componentes

Tú: "¿Cómo funciona el sistema de componentes de Flame?"

Respuesta: Documentación detallada sobre:

Ciclo de vida de los componentes
Jerarquía de componentes
Componentes integrados
Creación de componentes personalizados
Comunicación entre componentes

🔄 Mantenimiento

Actualizar la Caché de Documentación

# Update to latest Flame documentation
dart run bin/flame_sync_standalone.dart

Recompilar el Servidor

# Clean rebuild with fresh documentation
./build_clean.sh

📋 Requisitos Previos

Dart SDK: Versión 3.2.0 o superior
Conexión a Internet: Requerida para la sincronización inicial de documentación
Cliente MCP: Claude Desktop, Amazon Q CLI o cliente compatible

🐛 Solución de Problemas

Servidor No Encontrado

Asegúrate de usar la ruta absoluta al ejecutable en tu configuración de MCP
Verifica que el ejecutable exista: ls -la build/flame_mcp_live
Comprueba los permisos de archivo: chmod +x build/flame_mcp_live

Sin Resultados de Búsqueda

Ejecuta ./build_clean.sh para reconstruir la caché y el servidor
Comprueba que la caché exista: ls flame_docs_cache/
Verifica que la caché tenga contenido: find flame_docs_cache -name "*.md" | wc -l (debería mostrar ~146)

Problemas de Límite de Tasa

Configura un token de acceso personal de GitHub (consulta la sección de Configuración)
Comprueba el estado del límite de tasa en los registros de sincronización

📈 Rendimiento

Archivos de Documentación: 146 archivos Markdown
Tamaño de Caché: ~3 MB
Tiempo de Sincronización: 30-60 segundos (depende de la red)
Uso de Memoria: <50 MB en ejecución
Tiempo de Inicio: <2 segundos

🤝 Contribuciones

Haz un fork del repositorio
Crea una rama de funcionalidad
Realiza tus cambios
Prueba con ./build_clean.sh
Envía una solicitud de extracción

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT.

🔗 Enlaces Relacionados

¿Listo para empezar a crear juegos con Flame? Ejecuta ./build_clean.sh y añade el servidor a tu cliente MCP. 🎮