@layervai/qurl-mcp

⚠️ Переименован из @layerv/qurl-mcp в версии v0.4.0. Старый пакет устарел и больше не будет получать обновления. Если вы используете @layerv/qurl-mcp@0.3.x, замените область (scope) в конфигурации вашего MCP-клиента — бинарный файл и API-ключ остаются прежними, других изменений нет.

MCP-сервер для управления безопасными ссылками qURL™.

Quantum URL (qURL) · У интернета есть скрытый слой. Это способ попасть туда.

Что он делает

qURL MCP Server — это сервер Model Context Protocol, который позволяет ИИ-агентам (Claude, GPT, Cursor и др.) создавать, разрешать, перечислять и управлять безопасными ссылками qURL в нативном режиме. Он подключается к API qURL через транспорт stdio, поэтому любой MCP-совместимый клиент может использовать его без написания кода интеграции.

Related MCP server: unphurl-mcp

Быстрый старт

Добавьте сервер в конфигурацию вашего MCP-клиента (Claude Desktop, Claude Code и т. д.):

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

Замените lv_live_xxx на ваш реальный API-ключ. Ключ должен иметь соответствующие области доступа (scopes) для инструментов, которые вы планируете использовать (см. ниже).

Доступные инструменты

Доступные ресурсы

Конфигурация

Docker

Для контейнерного развертывания включен многоэтапный Dockerfile:

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

Образ запускается от имени пользователя node (не root), содержит только производственные зависимости и использует tini в качестве PID 1 для корректной обработки сигналов.

Если вызов инструмента возвращает missing_api_key, несмотря на то, что QURL_API_KEY кажется установленным, проверьте stderr на наличие предупреждения при загрузке — некоторые MCP-хосты скрывают stderr, а предупреждение — самый быстрый способ обнаружить значение, состоящее только из пробелов, или не установленное значение:

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

Разработка

npm install
npm run build
npm test
npm run lint

Дополнительные команды:

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

Лицензия

MIT -- LayerV AI