Skip to content

Repository files navigation

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 등)와 동일한 방식.


스택

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


스킬

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

About / 제작

Hermes Agent용 MCP — molpass의 바이브 코딩(vibe coding) 프로젝트.

  • 아이디어·방향: molpass (이정훈) · https://zeolinex.com
  • 기획: Claude (Chat)
  • 개발: Claude Code

자가 호스팅 Hermes Agent에 도구로 붙여 쓰는 MCP 서버입니다.

같은 모음:

License

MIT

About

Hermes Agent용 MCP — QR 코드 생성 (텍스트·URL → PNG). molpass · zeolinex.com · vibe-coded with Claude

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages