Skip to content

jwalsh/mcp-server-qrcode

Repository files navigation

MCP QR Code Server

Overview

Generate QR codes seamlessly using the Model Context Protocol (MCP). This server connects large language models to QR code generation capabilities across multiple client interfaces.

Features

  • Generate QR codes for multiple content types:
    • URLs and website links
    • WiFi network credentials
    • Contact information (vCard)
    • Plain text
    • Calendar events (iCal)
  • Multiple output formats:
    • PNG images (base64-encoded)
    • ASCII/text representation
    • Data URL format
  • Customization options:
    • Size adjustment (100-1000px)
    • Error correction levels (L, M, Q, H)
    • Format selection (image, text)

Quick Examples

Please generate a QR code for https://example.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: [email protected]
Phone: 555-123-4567

Installation

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

Usage

Claude Desktop

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

For detailed setup instructions, please refer to:

Claude Desktop

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

Emacs with mcp.el

;; Basic installation with straight.el
(use-package mcp
  :straight (mcp :type git :host github :repo "lizqwerscott/mcp.el"))
;; Connect to the QR code server
(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)))
;; Generate a QR code
(let ((connection (gethash "qrcode" mcp-server-connections)))
  (mcp-call-tool connection 
                "generate-qrcode" 
                '(:content "https://example.com" 
                  :format "text")))

MCP Inspector

npx -y @modelcontextprotocol/inspector npx -y @jwalsh/mcp-server-qrcode

NPM Package CLI

# Verify installation
echo '{"method":"tools/list","params":{},"id":1,"jsonrpc":"2.0"}' | mcp-server-qrcode | jq -r '.result.tools[]|.name'
# Generate QR code via JSON-RPC
echo '{"method":"tools/call","params":{"name":"generate-qrcode","arguments":{"content":"https://example.com","format":"text"}},"id":1,"jsonrpc":"2.0"}' | mcp-server-qrcode |  jq -r '.result.content[0].text'

█████████████████████████████████ █████████████████████████████████ ████ ▄▄▄▄▄ █▄▀ █ ▀ █▀█ ▄▄▄▄▄ ████ ████ █ █ █▄ ▄█▀ ▀█▄█ █ █ ████ ████ █▄▄▄█ █▀ █ ▀█ ███ █▄▄▄█ ████ ████▄▄▄▄▄▄▄█▄▀▄█ █ ▀ █▄▄▄▄▄▄▄████ ████ ▀▄▀▀▀▄▄▀▀ ▄▀▄▀▀ █▀▄▀ ████ ████▄▀█▄▀ ▄▄▀ ▀▀█▄▀▄█▀▄ ▄█▄████ █████▀▀▄ ▄▄▄ ▀ █ ▄█ █ ███▀ ████ ████▄▄▄█▄▄▄▀▄▀█▀ ▄ ▄ ▄▀▀ ▄█▄████ ████▄▄██▄█▄▄▀▄███ █ ▄▄▄ ██▄▀████ ████ ▄▄▄▄▄ █▄█▄▄█▀█▀ █▄█ ██▀ ████ ████ █ █ ██ █▄ ▄█▄▄ ▄▄ █▀ ▄████ ████ █▄▄▄█ █▄ █▀ ▄ ▀ ▄█▄▄████ ████▄▄▄▄▄▄▄█▄▄▄██▄▄█▄█▄██▄██▄████ █████████████████████████████████ █████████████████████████████████

Developer Documentation

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

About

Model Context Protocol server for generating QR codes

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors