@layervai/qurl-mcp

⚠️ 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キーに置き換えてください。キーには、使用するツールに応じた適切なスコープが必要です（下記参照）。

利用可能なツール

利用可能なリソース

設定

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