QR Code Generation MCP Server

1# QR Code Generation MCP Server
2 
3A QR code generation MCP server implemented using FastMCP, supporting text-to-QR code conversion with base64 encoding output.
4 
5<a href="https://glama.ai/mcp/servers/@2niuhe/qrcode_mcp">
6  <img width="380" height="200" src="https://glama.ai/mcp/servers/@2niuhe/qrcode_mcp/badge" />
7</a>
8 
9## Features
10 
11- Support for any text to QR code conversion (including Chinese characters)
12- Customizable colors and styles
13- Base64 encoding
14- Support for STDIO, HTTP, and SSE transport modes
15 
16## Installation
17 
18```bash
19uv sync
20# or
21pip install qrcode Pillow mcp
22```
23 
24## Usage
25 
26### 0. Docker Usage
27 
28#### Build Image
29```bash
30docker build -t qrcode-mcp .
31```
32 
33#### Run Container
34```bash
35# Default SSE mode
36docker run -p 8008:8008 qrcode-mcp
37 
38# HTTP mode
39docker run -p 8008:8008 -e TRANSPORT_MODE=http qrcode-mcp
40 
41# STDIO mode (for testing)
42docker run -e TRANSPORT_MODE=stdio qrcode-mcp
43 
44# Custom host and port
45docker run -p 9000:9000 -e TRANSPORT_MODE=http -e HOST=0.0.0.0 -e PORT=9000 qrcode-mcp
46```
47 
48#### Environment Variables
49- `TRANSPORT_MODE`: Transport mode (`sse`, `http`, `stdio`), default: `sse`
50- `HOST`: Host address to bind, default: `0.0.0.0`
51- `PORT`: Port to bind, default: `8008`
52 
53#### Docker Compose
54```yaml
55version: '3.8'
56services:
57  qrcode-mcp:
58    build: .
59    ports:
60      - "8008:8008"
61    environment:
62      - TRANSPORT_MODE=sse
63      - HOST=0.0.0.0
64      - PORT=8008
65```
66 
67### 1. MCP Server Mode
68 
69#### Start Server
70```bash
71# STDIO mode (for Claude Desktop)
72python qrcode_mcp_server.py
73 
74# HTTP mode
75python qrcode_mcp_server.py --http --host 127.0.0.1 --port 8008
76 
77# SSE mode (Server-Sent Events) Deprecated
78python qrcode_mcp_server.py --sse --host 127.0.0.1 --port 8008
79```
80 
81#### Configure Claude Desktop
82Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
83 
84**STDIO Mode (Local Use):**
85```json
86{
87  "mcpServers": {
88    "qrcode-mcp": {
89      "command": "python",
90      "args": ["/ABSOLUTE/PATH/TO/qrcode_mcp/qrcode_mcp_server.py"],
91      "cwd": "/ABSOLUTE/PATH/TO/qrcode_mcp"
92    }
93  }
94}
95```
96 
97**HTTP Mode (Network Deployment):**
98```json
99{
100  "mcpServers": {
101    "qrcode-mcp": {
102      "transport": "http",
103      "url": "http://127.0.0.1:8008/mcp/"
104    }
105  }
106}
107```
108 
109**SSE Mode (Server-Sent Events):**
110```json
111{
112  "mcpServers": {
113    "qrcode-mcp": {
114      "serverUrl": "http://127.0.0.1:8008/sse"
115    }
116  }
117}
118```
119 
120### 2. Direct Python API Usage
121 
122```python
123from qrcode_utils import text_to_qr_base64
124 
125# Basic usage
126base64_result = text_to_qr_base64("Hello, World!")
127 
128# Custom styling
129base64_result = text_to_qr_base64(
130    "Custom QR Code",
131    box_size=15,
132    fill_color="darkblue",
133    back_color="lightgray"
134)
135```
136 
137## MCP Tools
138 
139### `generate_qr_code`
140Generate QR code and return base64 encoding.
141 
142**Parameters:**
143- `text` (required): Text content to convert
144- `box_size` (optional): Pixel size of each box, default 10
145- `border` (optional): Number of border boxes, default 4
146- `fill_color` (optional): Foreground color, default "black"
147- `back_color` (optional): Background color, default "white"
148- `return_data_url` (optional): Whether to return Data URL format, default false
149 
150## Testing
151 
152```bash
153python test_mcp_client.py
154```
155 
156## License
157 
158MIT License