mcp-qr
Generates QR code PNG images from text or URLs with customizable options like size, color, and error correction level.
README
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 등)와 동일한 방식.
스택
- Node 20+ / TypeScript
@modelcontextprotocol/sdk(stdio)qrcode(PNG 생성)
로고 합성·라운드 스타일 등 후처리(sharp 기반)는 v1.1로 분리한다. v1은 색상/크기/여백/정정수준 조합까지.
스킬
페어링 스킬: skill/qr.skill.md — 사용자 의도를 generate_qr 파라미터로 매핑한다.
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.