@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

이미지는 루트가 아닌 node 사용자로 실행되며, 프로덕션 의존성만 포함하고, 깔끔한 신호 처리를 위해 tini를 PID 1로 사용합니다.

QURL_API_KEY가 설정된 것처럼 보이는데도 도구 호출이 missing_api_key를 반환하는 경우, 부팅 시 경고 메시지를 확인하세요. 일부 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