URL2QR converts URLs into scannable QR codes with shareable download links. Generate codes for websites, apps, forms, and digital content to streamline distribution across print materials, packaging, signage, and events. Key features of URL2QR: - Convert any URL to a QR code image with customizable error correction levels and dimensions - Receive HTTP download links for generated QR codes - Support for streamable HTTP transport protocol - Optional hosted remote service available for immediate use without installation - Compatible with Claude Desktop and other MCP-compatible AI assistants

🔗 URL2QR MCP Server

[](https://www.npmjs.com/package/@xingyuchen/url2qr-mcp) [](LICENSE) [](https://modelcontextprotocol.io)

A powerful MCP (Model Context Protocol) server that converts URLs into QR codes with downloadable links. Built with Express and TypeScript, providing seamless integration with AI assistants like Claude.

[](https://smithery.ai/server/@guangxiangdebizi/url2qr-mcp)

✨ Features

📦 Installation

Installing via Smithery

To install URL2QR automatically via Smithery:

npx -y @smithery/cli install @guangxiangdebizi/url2qr-mcp

Via npm (Global)

npm install -g @xingyuchen/url2qr-mcp

Via npm (Local Project)

npm install @xingyuchen/url2qr-mcp

From Source

git clone https://github.com/guangxiangdebizi/URL2QR-MCP.git
cd URL2QR-MCP
npm install
npm run build

🚀 Quick Start

Option 1: Use Remote Service (Recommended for Quick Testing) 🌍

No installation needed! We provide a hosted service for immediate use:

Add to your MCP client configuration (e.g., Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "url2qr": {
      "type": "streamableHttp",
      "url": "http://47.79.147.241:3055/mcp",
      "timeout": 600
    }
  }
}

✨ That's it! You can now use the QR code generation tool without running your own server.

Tip: When self-hosting on a public server, remember to set the PUBLIC_BASE_URL environment variable so that generated download links use your public domain instead of localhost.

Option 2: Run Your Own Local Server

#### 1. Start the Server

# If installed globally
url2qr-mcp
If installed locally or from source
npm start
For development
npm run dev

The server will start on http://localhost:3000 by default.

#### 2. Configure MCP Client

Add to your MCP client configuration (e.g., Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "url2qr": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp",
      "timeout": 600
    }
  }
}

3. Use the Tool

In Claude Desktop or any MCP-compatible client:

Convert https://github.com to a QR code

The AI will use the url_to_qrcode tool and provide you with a download link!

🔧 API Reference

Tool: url_to_qrcode

Converts a URL into a QR code image.

Parameters:

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | url | string | ✅ Yes | - | The URL to convert into a QR code | | errorCorrectionLevel | string | ❌ No | "M" | Error correction level: "L" (7%), "M" (15%), "Q" (25%), "H" (30%) | | width | number | ❌ No | 300 | Width of the QR code image in pixels |

Example Response:

✅ QR Code Generated Successfully
Original URL: https://github.com
Download Link: http://localhost:3000/qrcodes/qr-abc123.png
QR Code Details:
Filename: qr-abc123.png
Size: 300x300px
Error Correction: M

🌐 HTTP Endpoints

GET /

GET /health

Response:

{
  "status": "healthy",
  "transport": "streamable-http",
  "activeSessions": 2,
  "serverName": "URL2QR-MCP",
  "version": "1.0.0"
}

POST /mcp

GET /qrcodes/:filename

⚙️ Configuration

Create a .env file in the project root:

PORT=3000
QR_OUTPUT_DIR=./qrcodes
PUBLIC_BASE_URL is optional - auto-detected from request headers by default
PUBLIC_BASE_URL=http://localhost:3000

Environment Variables:

🎯 Auto-Detection Feature

The server automatically detects its public URL from incoming HTTP requests, so you don't need t