@layervai/qurl-mcp

⚠️ Renombrado desde @layerv/qurl-mcp en la v0.4.0. El paquete antiguo está obsoleto y no recibirá más actualizaciones. Si estás usando @layerv/qurl-mcp@0.3.x, cambia el ámbito (scope) en la configuración de tu cliente MCP; es el mismo binario, la misma clave API, sin otros cambios.

Servidor MCP para la gestión segura de enlaces qURL™.

Quantum URL (qURL) · Internet tiene una capa oculta. Así es como entras.

Qué hace

qURL MCP Server es un servidor del Protocolo de Contexto de Modelo (Model Context Protocol) que permite a los agentes de IA (Claude, GPT, Cursor, etc.) crear, resolver, listar y gestionar enlaces seguros qURL de forma nativa. Se conecta a la API de qURL a través del transporte stdio, por lo que cualquier cliente compatible con MCP puede usarlo sin código de integración personalizado.

Related MCP server: unphurl-mcp

Inicio rápido

Añade el servidor a la configuración de tu cliente MCP (Claude Desktop, Claude Code, etc.):

{
  "mcpServers": {
    "qurl": {
      "command": "npx",
      "args": ["@layervai/qurl-mcp"],
      "env": { "QURL_API_KEY": "lv_live_xxx" }
    }
  }
}

Reemplaza lv_live_xxx con tu clave API real. La clave debe tener los ámbitos adecuados para las herramientas que pretendes utilizar (ver más abajo).

Herramientas disponibles

Recursos disponibles

Configuración

Docker

Se incluye un Dockerfile multietapa para el despliegue basado en contenedores:

docker build -t qurl-mcp .
docker run -i -e QURL_API_KEY=lv_live_xxx qurl-mcp

La imagen se ejecuta como el usuario node (no root), solo incluye dependencias de producción y utiliza tini como PID 1 para un manejo limpio de señales.

Si una llamada a una herramienta devuelve missing_api_key a pesar de que QURL_API_KEY parece estar configurada, revisa stderr para ver la advertencia de tiempo de arranque; algunos hosts MCP ocultan stderr, y la advertencia es la forma más rápida de detectar un valor vacío o solo con espacios en blanco:

docker logs <container>          # if running detached
docker run -i -e QURL_API_KEY=lv_live_xxx qurl-mcp 2>&1  # interactive

Desarrollo

npm install
npm run build
npm test
npm run lint

Comandos adicionales:

npm run dev          # Watch mode (rebuild on changes)
npm run format       # Format source with Prettier
npm run format:check # Check formatting without modifying files

Licencia

MIT -- LayerV AI