URL2QR

You can transform any URL into a QR code and obtain a downloadable link for the image. This MCP server runs as a bridge between your AI assistant or MCP client and QR code generation, making it easy to share URLs in a scannable format or embed them in workflows. You have the option to use a hosted remote service for quick testing or run your own local instance for private, customizable use.

How to use

Configure your MCP client to connect to the URL2QR service, then issue a command to convert a URL into a QR code. You can either use the remote hosted service for instant testing or run a local server for full control. The client will return a downloadable link to the generated QR code image along with details about the image.

How to install

Prerequisites you need: Node.js and npm, or an environment that can run MCP HTTP endpoints. You can run the server locally or connect to a remote service.

Option A: Use the remote hosted service (no installation required) — configure your MCP client to use the remote endpoint below and start generating QR codes.

Option B: Run your own local server with these steps.

# If you want to run the server locally from a published package
# Global install (optional)
npm install -g @xingyuchen/url2qr-mcp

# Or install from source
# 1) Clone the repository
# git clone https://github.com/guangxiangdebizi/URL2QR-MCP.git
# 2) Install dependencies
# cd URL2QR-MCP
# npm install
# 3) Build the project (if required by the project setup)
# npm run build
# 4) Start the server
# npm start
# or for development
# npm run dev

# The server will run by default on http://localhost:3000

What you’ll configure in your MCP client

You will point your client to one or more MCP endpoints and set a timeout for operations. You can also rely on auto-detection to determine your public URL when running behind proxies.

Quick configuration example for a remote service (no local server required):

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

Additional notes

Public URL auto-detection is supported. If you run behind a reverse proxy, the server will infer its public address from request headers. Set PUBLIC_BASE_URL only if you need to override the detected URL.

Environment control is available through a .env file. Typical variables include PORT, QR_OUTPUT_DIR, and PUBLIC_BASE_URL.

Available tools

url_to_qrcode

Converts a URL into a QR code image and provides a downloadable link for the resulting QR file.