OpenQR
공식QR 코드를 생성하고, 호스팅된 MCP 서버(17개 도구)와 무료 REST API를 통해 스캔 분석 기능이 있는 동적(편집 가능한) QR 코드를 관리합니다.
OpenQR MCP(으)로 무엇을 할 수 있나요?
- 정적 QR 코드 생성 —
generate_qr를 통해 모든 텍스트나 URL에서 QR 코드를 요청하여 PNG 또는 SVG로 반환받을 수 있습니다. - 편집 가능한 동적 코드 생성 —
create_dynamic_qr를 사용하여 나중에 재인쇄 없이 대상을 변경할 수 있는 QR 코드를 만듭니다. - 코드 업데이트 및 관리 —
update_dynamic_qr로 대상, 라벨, 태그 또는 폴더를 수정하거나,list_dynamic_qr및delete_dynamic_qr로 목록 확인 및 삭제를 할 수 있습니다. - 인쇄 캠페인을 위한 대량 생성 —
bulk_create_dynamic_qr로 한 번에 최대 200개의 동적 코드를 생성할 수 있습니다. - 폴더 및 테마로 정리 —
create_folder로 폴더를 만들고create_theme로 재사용 가능한 스타일 프리셋을 저장하여 일관된 브랜딩을 적용할 수 있습니다. - 스캔 분석 추적 —
get_scans를 사용하여 국가별 데이터를 포함한 모든 동적 코드의 스캔 통계를 가져올 수 있습니다.
문서
OpenQR
무료, 오픈소스, 워터마크 없는 QR 코드 생성기. 브라우저에서 완전히 실행됩니다 — 추적 없음, 가입 없음, 제한 없음.
대부분의 온라인 QR 생성기는 "무료"라고 유인한 뒤 워터마크를 추가하거나, 다운로드 크기를 제한하거나, 벡터 내보내기를 유료화하거나, 코드를 그들의 서버를 통해 라우팅하여 결제를 중단하면 코드가 죽게 만듭니다. QR 코드는 생성 비용이 전혀 들지 않는 공개 표준(ISO/IEC 18004)일 뿐입니다. OpenQR은 그 원칙을 유지합니다.
이 저장소는 기본 생성기 도구 — 참조 오픈소스 구현입니다. 의도적으로 작고 포크하기 쉽게 설계되었습니다.
호스팅 버전: 무료 API, MCP 서버 및 편집 가능한 코드
이 저장소의 모든 것은 워터마크 없이, 만료 없이 무료로 유지됩니다. openqr.uk 의 호스팅 빌드는 편집 가능한 코드와 자동화를 원하는 사용자를 위한 선택적 계정 레이어를 추가합니다:
- 동적 / 편집 가능한 QR 코드 — 스캔 분석 포함. 인쇄한 후에도 대상을 변경할 수 있습니다. 무료 계정에서 3개 무료(국가별 7일간의 스캔 데이터); Pro는 월 £9 또는 연 £72로 무제한이며, 전체 분석 기록, 도시 및 지역 세부 정보, 기기 및 리퍼러 분석(CSV 내보내기 포함), 브랜드 하위 도메인, 비밀번호 보호 코드도 제공합니다.
- 무료 REST API. 코드 생성 및 동적 코드 관리를 프로그래밍 방식으로 수행합니다. OpenAPI 사양은
/openapi.json; 대화형 문서는 openqr.uk/api 에 있습니다. - 호스팅 MCP 서버 —
https://openqr.uk/mcp(Streamable HTTP, 17개 도구). Claude, Cursor 또는 모든 MCP 클라이언트에서 직접 QR 코드를 생성하고 관리합니다. 공식 MCP 레지스트리에 등재되어 있습니다. 원격 지원 클라이언트는 해당 URL에 직접 연결합니다; stdio 전용 클라이언트는npx -y @open-qr/mcp및OPENQR_API_KEY설정으로 브리지할 수 있습니다 (자세히).
이 저장소의 정적 생성기는 그 어떤 것도 호출하지 않습니다. 100% 클라이언트 측에서만 실행되며(개인정보 보호 참조), 생성기를 사용하거나 자체 호스팅하는 데 그 어떤 것도 필요하지 않습니다.
도구
https://openqr.uk/mcp 의 호스팅 MCP 서버는 17개 도구를 제공합니다. 모든 도구에는 무료 API 키가 필요합니다 — openqr.uk/api에서 생성하고 MCP 연결 시 Authorization: Bearer oqr_...로 전달하세요.
| 도구 | 기능 |
|---|---|
generate_qr | 모든 텍스트 또는 URL에서 정적 QR 코드를 생성합니다. PNG 이미지 또는 SVG 마크업을 반환합니다. |
create_dynamic_qr | 나중에 다시 인쇄하지 않고 대상을 변경할 수 있는 편집 가능한 QR 코드를 생성합니다. |
update_dynamic_qr | 동적 코드의 대상, 라벨, 사용자 지정 단축 링크, 태그 또는 폴더를 변경합니다. |
get_dynamic_qr | 하나의 코드에 대한 전체 세부 정보: 대상, 단축 링크, 라벨, 유형, 태그, 폴더, 상태, 생성 날짜. |
get_scans | 동적 코드의 스캔 통계. |
list_dynamic_qr | ID, 단축 URL, 대상, 라벨 및 상태와 함께 동적 코드 목록을 표시합니다. |
delete_dynamic_qr | 동적 코드를 영구적으로 삭제합니다. 단축 링크가 작동을 중지합니다. |
bulk_create_dynamic_qr | 한 번에 최대 200개의 동적 코드를 생성합니다. |
list_folders | 폴더 목록을 표시합니다. |
create_folder | 코드를 정리할 폴더를 생성합니다. |
delete_folder | 폴더를 삭제합니다. 코드는 삭제되지 않고 분류만 해제됩니다. |
list_themes | 저장된 스타일 테마 목록을 표시합니다. ID 또는 이름을 theme로 전달하여 적용합니다. |
create_theme | 재사용 가능한 스타일 테마(색상, 점 및 모서리 스타일)를 저장합니다. |
delete_theme | 저장된 테마를 삭제합니다. 이미 해당 테마로 스타일링된 코드는 모양을 유지합니다. |
get_subdomain | 계정의 브랜드 하위 도메인과 일시 중지 여부를 표시합니다. |
set_subdomain | 브랜드 하위 도메인을 신청하거나 변경하여 코드가 {name}.oqr.to에서도 확인되도록 합니다. Pro 전용. |
clear_subdomain | 브랜드 하위 도메인을 해제합니다. 코드는 일반 단축 링크에서 계속 작동합니다. |
또한 5개 리소스와 4개 프롬프트를 제공합니다:
- 리소스는
openqr://preset/classic,/teal,/high-contrast,/dots및/classy의 내장 QR 스타일 프리셋입니다. 하나를 읽고 해당 스타일을create_theme에 전달하세요. - 프롬프트는
create_tracked_qr,bulk_qr_for_print,brand_a_qr및qr_scan_report입니다.
기능
- 워터마크 없음, 크기 제한 없음, 가입 없음 — 모든 기능이 무료입니다
- 설계상 프라이버시 보호 — 코드가 브라우저에서 완전히 생성됩니다; 콘텐츠가 서버에 닿지 않습니다
- 어디서나 내보내기 — 최대 4096px의 PNG / WebP, 진정한 벡터 SVG 및 PDF
- 전체 스타일링 — 색상, 그라데이션, 점 및 모서리 스타일, 로고 삽입, "Scan me" 프레임
- 스마트 입력 — 링크 또는 텍스트를 붙여넣으면 유형이 자동 감지됩니다
- 풍부한 페이로드 — URL, 텍스트, 이메일, 전화, SMS, WhatsApp, Wi-Fi 및 지도 기반 위치 선택기
- 원클릭 복사, 공유 가능한 디자인 링크, 라이트/다크, 반응형, 키보드 접근성
빠른 시작
pnpm install
pnpm dev # http://localhost:3011
빌드 및 자체 호스팅
pnpm build
pnpm start # serves on :3011 (standalone output)
표준 Next.js 앱입니다 — 어디서든 호스팅할 수 있습니다(VPS, Raspberry Pi, Cloudflare, 모든 리버스 프록시 뒤). 실행에 환경 변수, 데이터베이스, 비밀번호가 필요 없습니다.
임베딩
<Generator/> 컴포넌트는 자체 포함되어 있으며 구성 가능합니다:
import { Generator } from "@/components/generator/generator";
// Full page (default OpenQR logo header):
<Generator />
// Embedded widget, your own branding, no default header:
<Generator embedded header={<MyLogo />} />
// Inject your own post-download call-to-action:
<Generator renderSuccess={(variant) => <MySupportCluster variant={variant} />} />
이 도구는 분석 기능이 전혀 없습니다. 익명 UI 이벤트(예: 사용된 내보내기 형식 — QR 콘텐츠는 절대 아님)를 원하면 핸들러를 주입하세요:
import { setTrackHandler } from "@/lib/analytics";
setTrackHandler((action, name, category) => myAnalytics.track(category, action, name));
개인정보 보호
QR 생성은 100% 브라우저에서 이루어집니다. 유일한 선택적 외부 호출은 위치 도구에 있습니다: CARTO의 지도 타일과 OpenStreetMap의 Nominatim을 통한 주소 조회. 그 외에는 어떤 것도 기기를 떠나지 않습니다.
기술 스택
Next.js 16 (App Router) · React 19 · TypeScript (strict) · Tailwind v4 ·
qr-code-styling · Leaflet · pnpm.
기여
CONTRIBUTING.md를 참조하세요. 단순하고, 접근 가능하며, 클라이언트 측에서, 무료로 유지하세요 — 워터마크 제거나 형식 잠금 해제에 결제가 필요한 기능은 없어야 합니다.
라이선스
AGPL-3.0 © 2026 Sam Moreton.
AGPL-3.0에 따라 OpenQR을 자유롭게 사용, 연구, 수정, 자체 호스팅 및 재배포할 수 있습니다. 수정된 버전을 네트워크 서비스로 실행하는 경우, AGPL은 동일한 라이선스로 소스를 공개하도록 요구합니다. 사용 사례에 맞지 않으면 상업용 라이선스를 이용할 수 있습니다 — NOTICE를 참조하세요.