Qrcode MCP

🚀 QRコード生成MCPサーバー

FastMCPを使用して実装されたQRコード生成MCPサーバーです。テキストをQRコードに変換し、Base64エンコードで出力することができます。

✨ 主な機能

• 任意のテキスト（中国語を含む）をQRコードに変換可能
• 色とスタイルをカスタマイズ可能
• 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 Desktop用）
python qrcode_mcp_server.py

# HTTPモード
python qrcode_mcp_server.py --http --host 127.0.0.1 --port 8008

# SSEモード（Server-Sent Events）非推奨
python qrcode_mcp_server.py --sse --host 127.0.0.1 --port 8008

Claude Desktopの設定

~/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モード（Server-Sent Events）:

{
  "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"
)

📚 詳細ドキュメント

generate_qr_code

QRコードを生成し、Base64エンコードで返します。

パラメータ:

• text (必須): 変換するテキスト内容
• box_size (オプション): 各ボックスのピクセルサイズ、デフォルト10
• border (オプション): ボーダーボックスの数、デフォルト4
• fill_color (オプション): 前景色、デフォルト "black"
• back_color (オプション): 背景色、デフォルト "white"
• return_data_url (オプション): Data URL形式で返すかどうか、デフォルトfalse

🧪 テスト

python test_mcp_client.py

📄 ライセンス

MITライセンス