mcp-server-qrcode

#+TITLE: 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

#+begin_example
Please generate a QR code for https://example.com
#+end_example

#+begin_example
Generate a QR code for the Wi-Fi network "GuestWiFi" with password "Welcome123"
#+end_example

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

• Installation

#+begin_src bash
npm install -g @jwalsh/mcp-server-qrcode
#+end_src

• Usage

** Claude Desktop
#+begin_src json
{
"mcpServers": {
"qrcode": {
"command": "npx",
"args": [
"-y",
"@jwalsh/mcp-server-qrcode"
]
}
}
}
#+end_src

For detailed setup instructions, please refer to:

• [[https://modelcontextprotocol.io/quickstart/user][MCP for Claude Desktop Users]]
• [[https://modelcontextprotocol.io/quickstart/server][Building MCP Servers]]
• [[https://docs.anthropic.com/en/docs/agents-and-tools/mcp][Anthropic MCP Documentation]]

** Claude Desktop

#+begin_src json
{
"mcpServers": {
"qrcode": {
"args": [
"-y",
"@jwalsh/mcp-server-qrcode"
],
"command": "npx"
}
}
}
#+end_src

** Emacs with mcp.el
#+begin_src elisp :results silent
;; Basic installation with straight.el
(use-package mcp
:straight (mcp :type git :host github :repo "lizqwerscott/mcp.el"))
#+end_src

#+begin_src elisp :results silent
;; 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)))
#+end_src

#+begin_src elisp :results raw :wrap example
;; Generate a QR code
(let ((connection (gethash "qrcode" mcp-server-connections)))
(mcp-call-tool connection
"generate-qrcode"
'(:content "https://example.com"
:format "text")))
#+end_src

#+RESULTS:
#+begin_example
(:content [(:type text :text QR Code for "https://example.com":

█████████████████████████████████
█████████████████████████████████
████ ▄▄▄▄▄ █▄▀ █ ▀ █▀█ ▄▄▄▄▄ ████
████ █ █ █▄ ▄█▀ ▀█▄█ █ █ ████
████ █▄▄▄█ █▀ █ ▀█ ███ █▄▄▄█ ████
████▄▄▄▄▄▄▄█▄▀▄█ █ ▀ █▄▄▄▄▄▄▄████
████ ▀▄▀▀▀▄▄▀▀ ▄▀▄▀▀ █▀▄▀ ████
████▄▀█▄▀ ▄▄▀ ▀▀█▄▀▄█▀▄ ▄█▄████
█████▀▀▄ ▄▄▄ ▀ █ ▄█ █ ███▀ ████
████▄▄▄█▄▄▄▀▄▀█▀ ▄ ▄ ▄▀▀ ▄█▄████
████▄▄██▄█▄▄▀▄███ █ ▄▄▄ ██▄▀████
████ ▄▄▄▄▄ █▄█▄▄█▀█▀ █▄█ ██▀ ████
████ █ █ ██ █▄ ▄█▄▄ ▄▄ █▀ ▄████
████ █▄▄▄█ █▄ █▀ ▄ ▀ ▄█▄▄████
████▄▄▄▄▄▄▄█▄▄▄██▄▄█▄█▄██▄██▄████
█████████████████████████████████
█████████████████████████████████
)])
#+end_example

** MCP Inspector

#+begin_src bash
npx -y @modelcontextprotocol/inspector npx -y @jwalsh/mcp-server-qrcode
#+end_src

** NPM Package CLI

#+begin_src bash

Verify installation

echo '{"method":"tools/list","params":{},"id":1,"jsonrpc":"2.0"}' | mcp-server-qrcode | jq -r '.result.tools[]|.name'
#+end_src

#+RESULTS:
: generate-qrcode

#+begin_src bash :results raw :results raw

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'
#+end_src

#+RESULTS:
QR Code for "https://example.com":

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

• Developer Documentation
  For detailed setup, installation, contribution guidelines, and additional integration methods, please refer to [[file:DEVELOPERS.org][DEVELOPERS.org]].