Overview

Generate QR codes seamlessly across multiple interfaces using the Model Context Protocol (MCP).

Installation

npm view @jwalsh/mcp-server-qrcode

npm install -g @jwalsh/mcp-server-qrcode

Quick Examples

With Claude Desktop

Ask Claude to generate a QR code for any content:

Please generate a QR code for https://anthropic.com

Generate a QR code for the Wi-Fi network "GuestWiFi" with password "Welcome123"

Create a QR code for my contact information:
Name: John Doe
Email: john@example.com
Phone: 555-123-4567

Usage

MCP Server Usage (Primary Mode)

# Install the MCP server globally
npm install -g @jwalsh/mcp-server-qrcode

# The server is now available for use with MCP clients
# such as Claude Desktop or MCP Inspector

With Claude Desktop

To use this QR code generator with Claude Desktop:

1. Configure Claude Desktop to use the MCP server
2. Use the "Generate QR Code" tool to create QR codes for:
   • URLs
   • Plain text
   • Contact information
   • Wi-Fi credentials

With MCP Inspector

For development and testing with MCP Inspector:

# Install the MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Run the inspector with the QR code server
mcp-inspector -- mcp-server-qrcode

Development & Testing

For local development and testing, you can use additional CLI features:

# Clone and set up the repository
git clone https://github.com/jwalsh/mcp-server-qrcode.git
cd mcp-server-qrcode
npm install
npm run build

# Run MCP server for Inspector testing
npm start

# Test CLI features locally (development only)
npm run cli -- -g "https://example.com"
npm run cli -- -g "https://example.com" -s 300 -e H

# Test stdin piping with the CLI (development only)
echo "https://example.com" | npm run cli
cat myfile.txt | npm run cli

Claude Desktop

{
  "mcpServers": {
    "qrcode": {
      "args": [
        "-y",
        "@jwalsh/mcp-server-qrcode"
      ],
      "command": "npx"
    }
  }
}

1. Open Claude Desktop
2. Use the integrated QR code generation feature
3. Select content to generate QR code

Emacs (mcp.el)

;; In Emacs with mcp.el loaded
(mcp-connect-server "qrcode" 
                    "npx" 
                    '("-y" "@jwalsh/mcp-server-qrcode")
                    :initial-callback
                    (lambda (connection)
                      (message "Connected to %s" (jsonrpc-name connection)))
                    :tools-callback
                    (lambda (connection tools)
                      (message "Available tools: %s" tools)))

Configuration Options

• --size: Set the size of the QR code in pixels (default: 200)
• --error-correction: Set error correction level
  • L: Low (7% of codewords can be restored)
  • M: Medium (15% of codewords can be restored)
  • Q: Quartile (25% of codewords can be restored)
  • H: High (30% of codewords can be restored)

Supported Input Types

• URLs
• Plain text
• Contact information
• Wi-Fi credentials
• Email addresses

Developer Documentation

For detailed setup, installation, and contribution guidelines, please refer to DEVELOPERS.org.

License

MIT License