Clix MCP Server

Servidor MCP de Clix para asistir en integraciones con el SDK/API de Clix mediante búsqueda semántica en la documentación y el código fuente del SDK de Clix (iOS, Android, Flutter, React Native).

Documentación

Clix MCP Server

npm version npm downloads License

Clix MCP Server permite a los agentes de IA ofrecer documentación de Clix fiable y en tiempo real, así como ejemplos de código del SDK, para integraciones fluidas directamente en cualquier cliente compatible con MCP.

Clix MCP Server implementa el Model Context Protocol (MCP), un estándar abierto que permite a los LLM interactuar con herramientas y datos externos.

Capacidades clave:

  • Búsqueda de documentación — Busca en la documentación de Clix (guías de usuario, referencia de API, solución de problemas, mejores prácticas) con clasificación semántica.
  • Búsqueda de SDK — Explora los SDK de Clix (iOS, Android, Flutter, React Native) y ejemplos de implementación. Descubre símbolos del SDK y obtén fragmentos listos para producción.

Instalación

Requisitos previos

  • Node.js >= 18

Inicio rápido

Instala Clix MCP Server:

npm i -g @clix-so/clix-mcp-server@latest

Crea o actualiza el .mcp.json en la raíz de tu proyecto (o en la ubicación de configuración que use tu cliente MCP). Usar npx garantiza que siempre ejecutes la versión publicada más reciente:

Configuración MCP compartida

Añade Clix con:

{
  "mcpServers": {
    "clix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
    }
  }
}

Coloca esto en la configuración MCP de tu cliente (por ejemplo, en la configuración de la extensión de VS Code, ~/.cursor/mcp.json o en la configuración MCP de tu cliente Copilot).

Configuración de Claude Code

Abre tu terminal para acceder a la CLI de Claude Code. Ejecuta el siguiente comando para registrar el Clix MCP Server.

claude mcp add --transport stdio clix-mcp-server -- npx -y @clix-so/clix-mcp-server@latest

Configuración de Codex

Abre ~/.codex/config.toml. Añade la siguiente configuración y reinicia la CLI de Codex:

[mcp_servers]
  [mcp_servers.clix]
  command = "npx"
  args = ["-y", "@clix-so/clix-mcp-server@latest"]

Reinicia tu cliente MCP para cargar la configuración.

Opciones de línea de comandos

clix-mcp-server [options]

--version, -v  Show version
--help, -h     Show help

Uso

Este paquete funciona como un servidor MCP. Una vez configurado en tu cliente MCP, puedes invocar search_docs y search_sdk directamente desde la paleta de herramientas del cliente o desde la interfaz del asistente.

Notas:

  • Se requiere acceso a la red para obtener páginas de documentación y archivos fuente del SDK.
  • Los tiempos de espera y los recuentos de resultados predeterminados se pueden ajustar mediante variables de entorno:
    • DOCS_SEARCH_MAX_RESULTS (predeterminado: 3)
    • SDK_SEARCH_MAX_RESULTS (predeterminado: 3)

Desarrollo local

Configuración local

# Clone and install
git clone https://github.com/clix-so/clix-mcp-server.git
cd clix-mcp-server
npm install

# Build
npm run build

# Run tests
npm test

# Development mode (watch for changes)
npm run dev

Configuración del cliente MCP para desarrollo local

Antes de que se publique el paquete, configura tu cliente MCP para que use la compilación local:

{
  "mcpServers": {
    "clix": {
      "command": "node",
      "args": ["/absolute/path/to/clix-mcp-server/dist/index.js"]
    }
  }
}

Reemplaza /absolute/path/to/clix-mcp-server con la ruta real de tu proyecto.

Contribuciones

¡Las contribuciones son bienvenidas! Lee nuestras directrices en CONTRIBUTING.md y abre un issue para discutir cambios significativos antes de enviar un PR.

Soporte

Si encuentras problemas o tienes solicitudes de funciones, abre un issue en GitHub. Para preguntas sobre el uso, consulta la documentación y los ejemplos que devuelven las herramientas.

Licencia

Licencia MIT con restricciones personalizadas: consulta LICENSE para obtener más detalles.

Recursos