Qrcodly Mcp Server

QRcodly

QRcodly 是一个免费、开源的二维码生成与管理平台。可创建、自定义和跟踪用于网址、联系方式、Wi-Fi 凭据等内容的二维码。

功能

• 多种二维码类型 — 网址、vCard、Wi-Fi、电子邮件、日历活动、位置、纯文本
• 全面自定义 — 颜色、尺寸、背景和自定义图标上传
• 导出格式 — PNG、JPEG、SVG
• 网址缩短与分析 — 缩短链接并跟踪扫码情况
• 模板 — 保存并重复使用二维码配置
• 自定义域名 — 使用自己的域名创建短网址（集成 Cloudflare）
• 国际化 — 支持 8 种语言（EN、DE、ES、FR、IT、NL、PL、RU）
• 身份验证 — 由 Clerk 提供支持
• 浏览器扩展 — 从任意页面生成二维码

Monorepo 结构

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 许可。