Qrcodly Mcp Server

QRcodly

QRcodly は、無料のオープンソース QR コード生成・管理プラットフォームです。URL、連絡先情報、Wi-Fi 認証情報などの QR コードを作成、カスタマイズ、追跡できます。

機能

• 複数の QR コードタイプ — URL、vCard、Wi-Fi、メール、カレンダーイベント、位置情報、プレーンテキスト
• 完全なカスタマイズ — 色、サイズ、背景、カスタムアイコンのアップロード
• エクスポート形式 — PNG、JPEG、SVG
• URL 短縮と分析 — リンクを短縮してスキャンを追跡
• テンプレート — QR コードの設定を保存して再利用
• カスタムドメイン — 短縮 URL に独自のドメインを使用（Cloudflare 連携）
• 国際化 — 8 言語（EN、DE、ES、FR、IT、NL、PL、RU）
• 認証 — Clerk による提供
• ブラウザ拡張機能 — 任意のページから QR コードを生成

モノレポ構成

qrcodly/
├── apps/
│   ├── backend/            # Fastify REST API
│   ├── frontend/           # Next.js web application
│   └── browser-extension/  # Vite-based browser extension
├── packages/
│   ├── shared/             # Zod schemas, DTOs, and shared utilities
│   ├── eslint-config/      # Shared ESLint configuration
│   └── typescript-config/  # Shared TypeScript configuration
└── docker-compose.yaml     # Local development services

アーキテクチャの詳細については、各アプリの README を参照してください: バックエンド · フロントエンド · ブラウザ拡張機能 · 共有パッケージ

技術スタック

レイヤー	技術
フロントエンド	Next.js、React、TypeScript、Tailwind CSS、shadcn/ui、Zustand、TanStack Query、next-intl
バックエンド	Fastify、TypeScript、Drizzle ORM、tsyringe（DI）、Zod、Nodemailer、Handlebars
データベース	MySQL、Redis
ストレージ	S3 / MinIO
認証	Clerk
課金	Stripe
分析	Umami、PostHog
モニタリング	Axiom、Sentry

前提条件

• Node.js >= 22.11
• pnpm >= 9.15
• Docker（ローカル開発サービス用）

クイックスタート

# 1. Clone the repository
git clone https://github.com/FloB95/qrcodly.git
cd qrcodly

# 2. Install dependencies
pnpm install

# 3. Start local services (MySQL, Redis, MinIO, Umami)
docker-compose up -d

# 4. Set up environment variables
cp apps/backend/.env.example apps/backend/.env
cp apps/frontend/.env.example apps/frontend/.env
# Edit both .env files with your configuration (Clerk keys, etc.)

# 5. Start development servers
pnpm run start:dev
# Backend API → http://localhost:5001
# Frontend   → http://localhost:3000

利用可能なスクリプト

スクリプト	説明
pnpm run start:dev	バックエンドとフロントエンドを開発モードで起動
pnpm run backend:dev	バックエンドのみを起動（先にマイグレーションを実行）
pnpm run frontend:dev	フロントエンドのみを起動
pnpm run build	すべてのアプリをビルド
pnpm run build:shared-package	共有パッケージのみをビルド
pnpm run lint	すべてのワークスペースをリント
pnpm run format	すべてのファイルを Prettier でフォーマット
pnpm run clean	すべてのアプリのビルド成果物をクリーン

ローカルサービス (Docker Compose)

サービス	ポート	詳細
MySQL	3306	認証情報: root / root、データベース: qrcodly
Redis	6379	—
MinIO (S3)	9000 (API), 9001 (Console)	認証情報: minio / testtest
phpMyAdmin	8081	—
Umami Analytics	3001	—

コントリビューション

コントリビューションを歓迎します！ガイドラインとセットアップ手順については、CONTRIBUTING.md をご覧ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。