Qrcode MCP

🚀 二維碼生成MCP服務器

本項目是一個使用FastMCP實現的二維碼生成MCP服務器，支持將文本轉換為二維碼，並以Base64編碼形式輸出。

🚀 快速開始

本二維碼生成MCP服務器支持將任意文本轉換為二維碼，操作簡單且功能豐富。你可以根據自己的需求選擇不同的安裝和使用方式。

✨ 主要特性

• 支持將任意文本（包括中文）轉換為二維碼。
• 可自定義二維碼的顏色和樣式。
• 輸出採用Base64編碼。
• 支持STDIO、HTTP和SSE傳輸模式。

📦 安裝指南

uv sync
# 或者
pip install qrcode Pillow mcp

💻 使用示例

基礎用法

0. Docker使用方式

構建鏡像

docker build -t qrcode-mcp .

運行容器

# 默認SSE模式
docker run -p 8008:8008 qrcode-mcp

# HTTP模式
docker run -p 8008:8008 -e TRANSPORT_MODE=http qrcode-mcp

# STDIO模式（用於測試）
docker run -e TRANSPORT_MODE=stdio qrcode-mcp

# 自定義主機和端口
docker run -p 9000:9000 -e TRANSPORT_MODE=http -e HOST=0.0.0.0 -e PORT=9000 qrcode-mcp

環境變量

• TRANSPORT_MODE：傳輸模式（sse、http、stdio），默認值：sse
• HOST：綁定的主機地址，默認值：0.0.0.0
• PORT：綁定的端口，默認值：8008

Docker Compose

version: '3.8'
services:
  qrcode-mcp:
    build: .
    ports:
      - "8008:8008"
    environment:
      - TRANSPORT_MODE=sse
      - HOST=0.0.0.0
      - PORT=8008

1. MCP服務器模式

啟動服務器

# STDIO模式（用於Claude桌面版）
python qrcode_mcp_server.py

# HTTP模式
python qrcode_mcp_server.py --http --host 127.0.0.1 --port 8008

# SSE模式（服務器發送事件，已棄用）
python qrcode_mcp_server.py --sse --host 127.0.0.1 --port 8008

配置Claude桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

STDIO模式（本地使用）

{
  "mcpServers": {
    "qrcode-mcp": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/TO/qrcode_mcp/qrcode_mcp_server.py"],
      "cwd": "/ABSOLUTE/PATH/TO/qrcode_mcp"
    }
  }
}

HTTP模式（網絡部署）

{
  "mcpServers": {
    "qrcode-mcp": {
      "transport": "http",
      "url": "http://127.0.0.1:8008/mcp/"
    }
  }
}

SSE模式（服務器發送事件）

{
  "mcpServers": {
    "qrcode-mcp": {
      "serverUrl": "http://127.0.0.1:8008/sse"
    }
  }
}

2. 直接使用Python API

from qrcode_utils import text_to_qr_base64

# 基本用法
base64_result = text_to_qr_base64("Hello, World!")

# 自定義樣式
base64_result = text_to_qr_base64(
    "Custom QR Code",
    box_size=15,
    fill_color="darkblue",
    back_color="lightgray"
)

高級用法

本項目提供了豐富的自定義選項，你可以根據需要調整二維碼的各種參數，如顏色、大小等。例如，在使用 text_to_qr_base64 函數時，可以傳入不同的參數來實現自定義樣式的二維碼生成。

📚 詳細文檔

MCP工具

generate_qr_code

生成二維碼並返回Base64編碼。

參數：

• text（必填）：要轉換的文本內容。
• box_size（可選）：每個方塊的像素大小，默認值為10。
• border（可選）：邊框方塊的數量，默認值為4。
• fill_color（可選）：前景色，默認值為 "black"。
• back_color（可選）：背景色，默認值為 "white"。
• return_data_url（可選）：是否返回Data URL格式，默認值為false。

🔧 技術細節

本項目使用FastMCP框架實現二維碼生成MCP服務器。通過將文本轉換為二維碼，並以Base64編碼形式輸出，支持多種傳輸模式和自定義樣式。在實現過程中，使用了qrcode和Pillow庫來生成和處理二維碼。

📄 許可證

本項目採用MIT許可證。