mcp-qr

텍스트/URL을 QR 코드 PNG로 생성해 반환하는 MCP 서버. Hermes에 "이거 QR로 보여줘"라고 하면 이미지를 돌려준다.

이 repo는 QR MCP인 동시에, 이후 Node 계열 MCP가 복사해 쓰는 레퍼런스 구조다. (표준: 00_MCP_표준_아키텍처_v1)

---

도구

generate_qr

QR 코드를 PNG로 생성한다.

파라미터	타입	필수	기본	설명
text	string	✅	—	인코딩할 텍스트/URL
errorCorrectionLevel	L|M|Q|H		M	오류 정정 수준
size	number(px)		512	출력 한 변 길이 (64–2048)
margin	number		2	여백(모듈 단위, 0–20)
darkColor	string(hex)		#000000	전경색
lightColor	string(hex)		#FFFFFF	배경색

출력: PNG image 콘텐츠 + 구조화 텍스트(인코딩한 원문, 적용된 옵션 요약).

예제 출력: examples/qr_example.png (https://zeolinex.com, 기본 옵션).

---

설치

git clone https://github.com/molpass/mcp-qr.git
cd mcp-qr
npm install && npm run build

예제 PNG를 직접 생성해 보려면:

npm run example   # examples/qr_example.png 재생성

---

Hermes / MCP 등록

MCP 클라이언트 설정(JSON)에 등록한다. 서버명은 qr:

{
  "mcpServers": {
    "qr": {
      "command": "node",
      "args": ["/abs/path/mcp-qr/dist/index.js"]
    }
  }
}

/abs/path 는 클론한 실제 절대경로로 바꾼다. Windows 예: "args": ["C:/Users/<you>/mcp-qr/dist/index.js"] 기존 등록 MCP(korean-law-mcp 등)와 동일한 방식.

---

스택

• Node 20+ / TypeScript
• @modelcontextprotocol/sdk (stdio)
• qrcode (PNG 생성)

로고 합성·라운드 스타일 등 후처리(sharp 기반)는 v1.1로 분리한다. v1은 색상/크기/여백/정정수준 조합까지.

---

스킬

페어링 스킬: skill/qr.skill.md — 사용자 의도를 generate_qr 파라미터로 매핑한다.

License

MIT