Skip to main content
Glama
mcp-qr
by molpass
README.md
# 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`](examples/qr_example.png) (`https://zeolinex.com`, 기본 옵션).

---

## 설치

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

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

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

---

## Hermes / MCP 등록

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

```json
{
  "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`](https://github.com/modelcontextprotocol/typescript-sdk) (stdio)
- [`qrcode`](https://www.npmjs.com/package/qrcode) (PNG 생성)

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

---

## 스킬

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

## About / 제작

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

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

자가 호스팅 [Hermes Agent](https://github.com/NousResearch/hermes-agent)에 도구로 붙여 쓰는 MCP 서버입니다.

같은 모음:
- [mcp-saju](https://github.com/molpass/mcp-saju) — 사주명리 만세력
- [mcp-qr](https://github.com/molpass/mcp-qr) — QR 코드 생성
- [mcp-biorhythm](https://github.com/molpass/mcp-biorhythm) — 바이오리듬
- [mcp-astrology](https://github.com/molpass/mcp-astrology) — 서양 점성술 네이탈 차트
- [mcp-ziwei](https://github.com/molpass/mcp-ziwei) — 자미두수 명반
- [mcp-numerology](https://github.com/molpass/mcp-numerology) — 수비학
- [mcp-liuren](https://github.com/molpass/mcp-liuren) — 대육임
- [mcp-qimen](https://github.com/molpass/mcp-qimen) — 기문둔갑
- [mcp-taiyi](https://github.com/molpass/mcp-taiyi) — 태을신수
- [mcp-weather](https://github.com/molpass/mcp-weather) — 한국 날씨·미세먼지
- [mcp-newsfeed](https://github.com/molpass/mcp-newsfeed) — 한국 주요뉴스

## License

MIT

TDQS

A3.6/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion. The tool has a unique purpose and is clearly distinguished by default.

Naming Consistency5/5

The single tool name 'generate_qr' follows a clear verb_noun pattern, which is consistent and predictable.

Tool Count4/5

Having only one tool is slightly below the typical well-scoped range (3-15), but for a focused QR code generator this is reasonable and not excessive.

Completeness4/5

The tool covers core QR code generation with customization options, but lacks related operations like reading or decoding, which would make the surface more complete.

Maintenance

ActivityInactive
ResponsivenessNo recent community issues