qrcode

This QR Code MCP server generate QR codes from text or URLs using Node.js and TypeScript. It exposes MCP commands to create QR codes in multiple formats such as Data URL (base64), SVG, and a terminal-friendly representation, with options for error correction level, size, margins, and colors. It also supports batch generation to process several inputs in one operation. You can interact with these tools through any MCP client by sending the appropriate command and parameters described in the tool docs. For example, you can request a data URL for a given text, generate an SVG with custom width and margin, or display a terminal-friendly QR code for quick verification. The batch tool allows processing up to 10 inputs in a single call, returning corresponding outputs for each input.

Prerequisites:

• Node.js 18.x or newer
• npm or yarn

Option A: Docker/Podman (recommended for isolation)

1. Install Docker or Podman on your system
2. Pull the image: docker pull antobrugnot/qrcode-mcp-server:latest
3. Run the server: docker run -i --rm antobrugnot/qrcode-mcp-server:latest

Option B: Local installation (development)

1. Clone the repository: git clone <your-repo-url> cd qrcode-mcp
2. Install dependencies: npm install
3. Build the project (TypeScript): npm run build
4. Start the server (production): npm start

Notes:

• If you build locally, the entry point for MCP is typically dist/index.js.
• Ensure your environment uses Node.js 18+ as indicated by the project.

Tips and common issues:

• The MCP server supports up to 10 texts for the batch tool. Use the texts array for batch requests.
• When running via Docker/Podman, you can map ports or volumes if you need to persist outputs or logs.
• For color customization, provide color.dark and color.light in options. Be mindful of valid hex color codes.
• If you see module resolution errors after pulling a docker image, try pulling the latest tag or rebuilding locally to ensure dependencies match your environment.
• Environment variables can be extended in the mcp_config by adding an env object with required keys and descriptions.