Skip to main content
Glama
molpass
by molpass

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, 기본 옵션).


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 등)와 동일한 방식.


스택

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


스킬

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

About / 제작

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

  • 아이디어·방향: molpass (이정훈) · https://zeolinex.com

  • 기획: Claude (Chat)

  • 개발: Claude Code

자가 호스팅 Hermes Agent에 도구로 붙여 쓰는 MCP 서버입니다.

같은 모음:

License

MIT

Available Tools

1 tool
generate_qrGenerate QR CodeB

텍스트나 URL을 받아 QR 코드를 PNG 이미지로 생성한다. 색상·크기·여백·오류정정 수준을 조절할 수 있다.

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes인코딩할 텍스트 또는 URL
errorCorrectionLevelNo오류 정정 수준 (L<M<Q<H)M
sizeNo출력 한 변 길이(px)
marginNo여백(모듈 단위)
darkColorNo전경색 (hex, 예: #000000)#000000
lightColorNo배경색 (hex, 예: #FFFFFF)#FFFFFF

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It mentions generating a PNG image but does not specify how the image is returned (e.g., as binary data, base64, or a URL). Missing information about output format, error handling, or performance implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences that efficiently convey the purpose and key customization options. No unnecessary words or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While the purpose is clear, the description lacks details about output handling (e.g., return type, storage), error behavior, and any prerequisites. For a tool with no annotations and no output schema, this leaves significant gaps in context needed for reliable invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers 100% of parameters with clear descriptions. The description adds a summary of adjustable attributes (color, size, margin, error correction), but this largely restates what is already in the schema, providing minimal additional semantic value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that the tool takes text or URL and generates a QR code as a PNG image. It provides a specific verb (generate) and resource (QR code), leaving no ambiguity about the tool's core function.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives, and no mention of prerequisites or limitations. The description simply states what the tool does without any contextual usage advice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev1.0.0
    • First observedgenerate_qr

TDQS

A3.6/5.0
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

ActivityStale
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables generation of QR codes from text or URLs in multiple formats (DataURL, SVG, terminal display) with customizable options like error correction, colors, and size. Supports batch processing of multiple QR codes and integrates seamlessly with MCP-compatible clients.
    4
    4
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Converts URLs into scannable QR codes with customizable options like error correction levels and image sizes. Provides downloadable links for generated QR codes through a simple MCP tool interface.
    18
    4
    Apache 2.0
  • A
    license
    B
    quality
    D
    maintenance
    Enables generation of customizable QR codes through the API Ninjas service, supporting multiple image formats (PNG, JPG, SVG, EPS) with configurable colors and sizes.
    1
    MIT
  • A
    license
    B
    quality
    F
    maintenance
    Enables AI assistants to generate QR codes for URLs, text, vCard, WiFi, email, and phone numbers with customizable size, colors, and error correction.
    1
    22
    1
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/molpass/mcp-qr'

If you have feedback or need assistance with the MCP directory API, please join our Discord server