# 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