Scan QRCode

You can run a local MCP server that decodes QR codes from either a data URL or an HTTP(S) image URL. It exposes two precise tools for decoding and returns the decoded text, enabling seamless QR code processing within your MCP workflows.

How to use

You interact with the QRCode MCP Server through an MCP client. Start the server locally and connect to it using the client’s standard tool invocation flow. Use the decode_qrcode_data_url tool when you have a base64 data URL representing the QR image, or use the decode_qrcode_image_url tool when you have a direct HTTP(S) URL to the QR image. The server will return the decoded text as the response.

How to install

Prerequisites you need before installing: the Node.js runtime (version 18.17 or higher) installed on your system.

Install and configure the QRCode MCP Server using one of the two supported methods.

Standard config (recommended, uses npx) setup:

{
  "mcpServers": {
    "qrcode": {
      "command": "npx",
      "args": [
        "scan-qrcode-mcp@latest"
      ]
    }
  }
}

Additional notes

Alternative using the global binary after installing it globally with npm: you can run the MCP server as a direct binary.

Alternative config (global binary) setup:

{
  "mcpServers": {
    "qrcode": {
      "command": "scan-qrcode-mcp",
      "args": []
    }
  }
}

Security and environment considerations

The server processes two types of inputs. For data URLs, ensure the value is a base64-encoded data URL. For image URLs, only HTTP(S) URLs are allowed. Do not pass untrusted remote URLs without proper allowlisting in your environment.

Node.js version requirements, and the need to ensure your global npm bin is on PATH if you rely on a global binary.

Available tools

decode_qrcode_data_url

Decodes a QR code from a base64-encoded data URL and returns the extracted text.

decode_qrcode_image_url

Decodes a QR code from an HTTP(S) image URL and returns the extracted text.