텍스트/URL을 QR 코드 PNG로 생성해 반환하는 MCP 서버. Hermes에 "이거 QR로 보여줘"라고 하면 이미지를 돌려준다.
이 repo는 QR MCP인 동시에, 이후 Node 계열 MCP가 복사해 쓰는 레퍼런스 구조다. (표준:
00_MCP_표준_아키텍처_v1)
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 재생성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 파라미터로 매핑한다.
Hermes Agent용 MCP — molpass의 바이브 코딩(vibe coding) 프로젝트.
- 아이디어·방향: molpass (이정훈) · https://zeolinex.com
- 기획: Claude (Chat)
- 개발: Claude Code
자가 호스팅 Hermes Agent에 도구로 붙여 쓰는 MCP 서버입니다.
같은 모음:
- mcp-saju — 사주명리 만세력
- mcp-qr — QR 코드 생성
- mcp-biorhythm — 바이오리듬
- mcp-astrology — 서양 점성술 네이탈 차트
- mcp-ziwei — 자미두수 명반
- mcp-numerology — 수비학
- mcp-liuren — 대육임
- mcp-qimen — 기문둔갑
- mcp-taiyi — 태을신수
- mcp-weather — 한국 날씨·미세먼지
- mcp-newsfeed — 한국 주요뉴스
MIT