mcp-qr

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

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

도구

generate_qr

QR 코드를 PNG로 생성한다.

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

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

Related MCP server: URL2QR MCP Server

설치

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