Skip to main content
Glama

@layervai/qurl-mcp

npm version

⚠️ 自 v0.4.0 起从 @layerv/qurl-mcp 更名。 旧包已弃用,将不再接收更新。如果您正在使用 @layerv/qurl-mcp@0.3.x,请在您的 MCP 客户端配置中更换作用域——二进制文件和 API 密钥保持不变,无需其他更改。

用于 qURL™ 安全链接管理的 MCP 服务器。

Quantum URL (qURL) · 互联网存在一个隐藏层。这就是进入的方式。

功能简介

qURL MCP 服务器是一个 Model Context Protocol 服务器,允许 AI 代理(Claude、GPT、Cursor 等)原生创建、解析、列出和管理 qURL 安全链接。它通过 stdio 传输连接到 qURL API,因此任何兼容 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 密钥。该密钥必须具备您打算使用的工具所需的相应作用域(见下文)。

可用工具

工具

描述

所需作用域

create_qurl

为受保护资源创建安全且受策略约束的链接

qurl:write

resolve_qurl

解析访问令牌以获取目标 URL 并开启防火墙访问

qurl:resolve

list_qurls

列出活跃的 qURL,支持分页

qurl:read

get_qurl

通过资源 ID 获取特定 qURL 的详细信息

qurl:read

delete_qurl

撤销 qURL,立即失效该链接

qurl:write

extend_qurl

延长活跃 qURL 的过期时间(update_qurl 的别名)

qurl:write

update_qurl

更新活跃 qURL 的过期时间、标签或描述

qurl:write

mint_link

为现有的受保护资源生成新的访问链接

qurl:write

batch_create_qurls

在单次调用中创建多个 qURL

qurl:write

可用资源

URI

名称

描述

qurl://links

活跃 qURL 链接

所有活跃 qURL 链接的列表

qurl://usage

qURL 使用情况与配额

当前配额和使用信息

配置

环境变量

必需

描述

默认值

QURL_API_KEY

有条件(见描述)

具有相应作用域(qurl:read, qurl:write, qurl:resolve)的 API 密钥。服务器在没有密钥的情况下也能启动,以便 MCP 自省(tools/list, resources/list, prompts/list)可用于目录探测——仅在首次调用工具或读取资源时需要,此时调用会抛出类型化的 missing_api_key 错误,直到设置密钥为止。

--

QURL_API_URL

qURL API 基础 URL

https://api.layerv.ai

Docker

包含一个用于容器化部署的多阶段 Dockerfile:

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

该镜像以非 root 的 node 用户身份运行,仅包含生产依赖项,并使用 tini 作为 PID 1 以实现干净的信号处理。

如果尽管设置了 QURL_API_KEY,工具调用仍返回 missing_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

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
4hResponse time
1wRelease cycle
10Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    SafeLink lets AI agents hire other AI agents — and get hired — with cryptographic guarantees instead of trust. Every hire goes through a payment-locked escrow, a proof-of-work verification step, and a tiered risk approval gate before any funds move.
    15
    4
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    URL intelligence for AI agents. One URL in, structured security and data quality signals out across 7 dimensions. 13 tools, risk score 0-100 with 23 configurable weights.
    16
    160
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Generate styled QR codes, manage dynamic short links with click analytics, and publish micro-landing pages via AI agents.
    19
    56
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    QrVerloz lets AI agents create QR codes instantly — no account needed, active for 90 days, and claimable at any time to make them permanent. Retarget the destination URL whenever you need, without reprinting.
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • URL intelligence for AI agents and developers. 16 tools, 25 signal weights, 20 free checks.

  • Verified, sourced, real-time intelligence layer for AI agents.

  • Build personal interactive apps with real URLs and persistent storage, using any AI.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/layervai/qurl-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server