Servidor MCP de Documentación de SFML 3.1.0 (sfml3-ref)

Un servidor oficial del Model Context Protocol (MCP) que proporciona a los asistentes de IA (Claude Desktop, Cursor, Claude Code, Cline, etc.) acceso directo y sin conexión a la documentación de referencia completa de SFML 3.1.0 en C++.

🌟 Características

• Referencia de API en Markdown limpio: documentación HTML de Doxygen analizada y limpiada en Markdown de GitHub con bloques de código C++ resaltados con sintaxis.

• Firmas C++20 completas: prototipos de métodos completos con especificadores ([[nodiscard]], constexpr, explicit, delete, argumentos por defecto).

• Categorizado por módulo: más de 155 símbolos categorizados en los 5 módulos de SFML: System, Window, Graphics, Audio y Network.

• Búsqueda rápida en memoria: búsqueda en menos de un milisegundo entre nombres de símbolos, funciones miembro, parámetros y descripciones.

• Alias inteligentes: resolución directa de typedefs y ayudantes comunes de SFML (por ejemplo, Vector2f ➔ sf::Vector2<T>, IntRect ➔ sf::Rect<T>, seconds ➔ sf::Time).

Related MCP server: godot-mcp-docs

🛠️ Herramientas MCP

🚀 Primeros pasos

Requisitos previos

• Node.js (se recomienda v18.0.0 o superior)

• npm

Instalación y compilación

# 1. Clone the repository
git clone https://github.com/Floxius/sfml3-ref.git
cd sfml3-ref

# 2. Install dependencies
npm install

# 3. Build the TypeScript server
npm run build

Nota: El repositorio ya incluye el index.json precompilado (~1 MB), por lo que no necesitas descargar los archivos HTML de Doxygen de SFML a menos que quieras volver a ejecutar el script de indexación.

🖥️ Configuración del cliente

1. Claude Desktop

Añade el servidor a tu archivo de configuración de Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sfml3-ref": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/sfml3-ref/dist/src/index.js"
      ]
    }
  }
}

(En Windows, usa barras normales o dobles barras invertidas, por ejemplo, C:/Users/<username>/Documents/sfml3-ref/dist/src/index.js)

Alternativa: ejecutar directamente con tsx (no se requiere paso de compilación)

{
  "mcpServers": {
    "sfml3-ref": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "/ABSOLUTE/PATH/TO/sfml3-ref/src/index.ts"
      ]
    }
  }
}

2. Cursor / Cline / Otros clientes MCP

Añade un servidor MCP STDIO con:

• Comando: node

• Argumentos: ["/path/to/sfml3-ref/dist/src/index.js"]

📖 Ejemplos de uso

Una vez conectado en Claude o en tu cliente MCP, puedes hacer preguntas como:

• "Enumera todos los módulos disponibles en SFML 3.1."

• "Muéstrame todas las clases y funciones del módulo Graphics de SFML."

• "¿Cuál es la firma del constructor de sf::Sprite en SFML 3?"

• "¿Cómo consulto registros DNS con sf::Dns en SFML 3.1?"

• "Busca métodos de manejo de eventos en SFML 3."

🔄 Reconstrucción del índice (opcional)

Si deseas volver a generar index.json desde cero:

1. Descarga la documentación HTML de Doxygen de SFML 3.1.0 desde el sitio web de SFML.

2. Extrae los archivos HTML en una carpeta llamada SFML-3.1.0 en la raíz del repositorio.

3. Ejecuta el script de indexación:

npm run build:index

📄 Licencia

• Código del servidor: Licenciado bajo la Licencia MIT.

• Documentación y biblioteca de SFML: Copyright © Laurent Gomila y el equipo de SFML. SFML está licenciado bajo los términos y condiciones de la licencia zlib/png.