@layervai/qurl-mcp

⚠️ Umbenannt von @layerv/qurl-mcp in v0.4.0. Das alte Paket ist veraltet und erhält keine weiteren Updates. Wenn Sie @layerv/qurl-mcp@0.3.x verwenden, tauschen Sie den Scope in Ihrer MCP-Client-Konfiguration aus — gleiches Binary, gleicher API-Schlüssel, keine weiteren Änderungen.

MCP-Server für qURL™ sichere Link-Verwaltung.

Quantum URL (qURL) · Das Internet hat eine verborgene Ebene. So gelangen Sie hinein.

Was es bewirkt

qURL MCP Server ist ein Model Context Protocol-Server, der es KI-Agenten (Claude, GPT, Cursor usw.) ermöglicht, sichere qURL-Links nativ zu erstellen, aufzulösen, aufzulisten und zu verwalten. Er verbindet sich über stdio-Transport mit der qURL-API, sodass jeder MCP-kompatible Client ihn ohne benutzerdefinierten Integrationscode verwenden kann.

Related MCP server: unphurl-mcp

Schnellstart

Fügen Sie den Server zu Ihrer MCP-Client-Konfiguration hinzu (Claude Desktop, Claude Code usw.):

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

Ersetzen Sie lv_live_xxx durch Ihren tatsächlichen API-Schlüssel. Der Schlüssel muss über die entsprechenden Scopes für die Tools verfügen, die Sie verwenden möchten (siehe unten).

Verfügbare Tools

Verfügbare Ressourcen

Konfiguration

Docker

Ein mehrstufiges Dockerfile ist für die containerbasierte Bereitstellung enthalten:

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

Das Image läuft als Nicht-Root-node-Benutzer, liefert nur Produktionsabhängigkeiten aus und verwendet tini als PID 1 für eine saubere Signalverarbeitung.

Wenn ein Tool-Aufruf missing_api_key zurückgibt, obwohl QURL_API_KEY gesetzt zu sein scheint, überprüfen Sie stderr auf die Warnung beim Booten — einige MCP-Hosts verbergen stderr, und die Warnung ist der schnellste Weg, einen nur aus Leerzeichen bestehenden oder nicht gesetzten Wert zu erkennen:

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

Entwicklung

npm install
npm run build
npm test
npm run lint

Zusätzliche Befehle:

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

Lizenz

MIT -- LayerV AI