Luskad MCP

Luskad MCP

Un servidor de Model Context Protocol (MCP) que proporciona acceso a reglas de codificación y ejemplos para tus proyectos.

Características

• Gestión de Proyectos: Recupera todos los proyectos disponibles con sus detalles
• Reglas de Codificación: Busca y accede a estándares de codificación dentro de proyectos específicos
• Colaboración en Equipo: Obtén información de los miembros del equipo y contactos del proyecto
• Seguimiento de Progreso: Monitorea el progreso del proyecto, riesgos y tareas
• Gestión de Funcionalidades: Accede a las funcionalidades del proyecto y sus problemas asociados
• Configuración Flexible: Soporte para variables de entorno y argumentos de línea de comandos
• Multiplataforma: Compatible con Cursor, Windsurf, VS Code y Claude Desktop

Requisitos previos

• Node.js (v16 o superior)
• npm o yarn
• Cursor, Windsurf, Claude Desktop u otro Cliente MCP

También necesitas crear una cuenta en la aplicación luskad.com y generar tu token de API.

Primeros pasos

Instalación en Cursor

Ve a: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pegar la siguiente configuración en tu archivo ~/.cursor/mcp.json de Cursor es el enfoque recomendado. Consulta la documentación de Cursor MCP para más información.

{
  "mcpServers": {
    "Luskad": {
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

Instalación en Windsurf

Añade esto a tu archivo de configuración MCP de Windsurf. Consulta la documentación de Windsurf MCP para más información.

{
  "mcpServers": {
    "luskad": {
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

Instalación en VSCode

Añade esto a tu archivo de configuración MCP de VS Code. Consulta la documentación de VS Code MCP para más información.

{
  "servers": {
    "luskad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

Instalación en Claude Desktop

Añade esto a tu archivo claude_desktop_config.json de Claude Desktop. Consulta la documentación de Claude Desktop MCP para más información.

{
  "mcpServers": {
    "luskad": {
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

Herramientas Disponibles

list-projects

Recupera todos los proyectos disponibles.

get-coding-rules

Busca reglas de codificación para un proyecto determinado. Parámetros:

• projectId: Proyecto para buscar reglas de codificación
• query: (Opcional) Consulta de búsqueda

Desarrollo

1. Clona el repositorio:

git clone https://github.com/frocher/luskad-mcp.git
cd luskad-mcp

2. Instala las dependencias:

npm install

3. Compila

npm run build

Configuración

Crea un archivo .env en el directorio raíz con las siguientes variables:

API_URL=https://app.luskad.com/api/v1
API_KEY=<your api key>

O proporciona la URL mediante la línea de comandos:

node dist/index.js --url http://your-api-url --key <your api key>

Ejemplo de configuración local

{
  "mcpServers": {
    "luskad": {
      "command": "npx",
      "args": [
        "tsx", "/path/to/folder/luskad-mcp/src/index.ts",
        "--url", "http://localhost:3000/api/v1",
        "--key", "<your personal key>"
      ]
    }
  }
}

Pruebas con MCP Inspector

npx -y @modelcontextprotocol/inspector npx @acmada/luskad-mcp@latest

Licencia

Licencia MIT - consulta LICENSE para más detalles.