Skip to main content
Glama

URL2QR MCP Server

by guangxiangdebizi
GitHub
JavaScript
2
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

šŸ”— URL2QR MCP Server

npm version License MCP

A powerful MCP (Model Context Protocol) server that converts URLs into QR codes with downloadable links. Built with Express and TypeScript, providing seamless integration with AI assistants like Claude.

āœØ Features

  • šŸ”— URL to QR Code Conversion - Transform any URL into a scannable QR code

  • šŸ“„ Downloadable Links - Get HTTP download links for generated QR codes

  • āš™ļø Customizable Options - Control error correction level and image size

  • šŸš€ Streamable HTTP - Modern MCP transport protocol support

  • šŸŒ Remote Service Available - Use our hosted service at http://47.79.147.241:3055/mcp

  • šŸ”Œ Easy Integration - Works with Claude Desktop and other MCP clients

  • šŸŽØ Clean API - RESTful endpoints for health checks and file serving

šŸ“¦ Installation

Via npm (Global)

npm install -g @xingyuchen/url2qr-mcp

Via npm (Local Project)

npm install @xingyuchen/url2qr-mcp

From Source

git clone https://github.com/guangxiangdebizi/URL2QR-MCP.git cd URL2QR-MCP npm install npm run build

šŸš€ Quick Start

Option 1: Use Remote Service (Recommended for Quick Testing) šŸŒ

No installation needed! We provide a hosted service for immediate use:

Add to your MCP client configuration (e.g., Claude Desktop's claude_desktop_config.json):

{ "mcpServers": { "url2qr": { "type": "streamableHttp", "url": "http://47.79.147.241:3055/mcp", "timeout": 600 } } }

āœØ That's it! You can now use the QR code generation tool without running your own server.

Option 2: Run Your Own Local Server

1. Start the Server

# If installed globally url2qr-mcp # If installed locally or from source npm start # For development npm run dev

The server will start on http://localhost:3000 by default.

2. Configure MCP Client

Add to your MCP client configuration (e.g., Claude Desktop's claude_desktop_config.json):

{ "mcpServers": { "url2qr": { "type": "streamableHttp", "url": "http://localhost:3000/mcp", "timeout": 600 } } }

3. Use the Tool

In Claude Desktop or any MCP-compatible client:

Convert https://github.com to a QR code

The AI will use the url_to_qrcode tool and provide you with a download link!

šŸ”§ API Reference

Tool: url_to_qrcode

Converts a URL into a QR code image.

Parameters:

Parameter

Type

Required

Default

Description

url

string

āœ… Yes

-

The URL to convert into a QR code

errorCorrectionLevel

string

āŒ No

"M"

Error correction level: "L" (7%), "M" (15%), "Q" (25%), "H" (30%)

width

number

āŒ No

300

Width of the QR code image in pixels

Example Response:

āœ… QR Code Generated Successfully Original URL: https://github.com Download Link: http://localhost:3000/qrcodes/qr-abc123.png QR Code Details: - Filename: qr-abc123.png - Size: 300x300px - Error Correction: M

šŸŒ HTTP Endpoints

GET /

API information and documentation.

GET /health

Health check endpoint.

Response:

{ "status": "healthy", "transport": "streamable-http", "activeSessions": 2, "serverName": "URL2QR-MCP", "version": "1.0.0" }

POST /mcp

MCP protocol endpoint (JSON-RPC).

GET /qrcodes/:filename

Download generated QR code images.

āš™ļø Configuration

Create a .env file in the project root:

PORT=3000 QR_OUTPUT_DIR=./qrcodes

Environment Variables:

  • PORT - Server port (default: 3000)

  • QR_OUTPUT_DIR - Directory for storing QR code images (default: ./qrcodes)

šŸ—ļø Project Structure

URL2QR-MCP/ ā”œā”€ā”€ src/ ā”‚ ā”œā”€ā”€ index.ts # MCP server entry point ā”‚ ā””ā”€ā”€ tools/ ā”‚ ā””ā”€ā”€ url2qr.ts # QR code generation tool ā”œā”€ā”€ qrcodes/ # Generated QR codes (auto-created) ā”œā”€ā”€ build/ # Compiled JavaScript (auto-generated) ā”œā”€ā”€ package.json ā”œā”€ā”€ tsconfig.json ā”œā”€ā”€ .env # Configuration ā””ā”€ā”€ README.md

šŸ”’ Session Management

The server implements automatic session cleanup:

  • Sessions expire after 30 minutes of inactivity

  • Cleanup runs every 15 minutes

  • Session IDs are managed via Mcp-Session-Id headers

šŸŒ Deployment Options

Remote Service (Production)

We provide a hosted service at:

  • Endpoint: http://47.79.147.241:3055/mcp

  • Health Check: http://47.79.147.241:3055/health

  • Status: šŸŸ¢ Online and ready to use

This is perfect for:

  • Quick testing without setup

  • Production use without infrastructure

  • Teams sharing a single endpoint

Local Deployment

Run your own instance for:

  • Development and testing

  • Private/isolated environments

  • Custom configurations

  • On-premise requirements

šŸ“ Examples

Basic Usage

// Tool parameters { "url": "https://example.com" }

Custom Error Correction

{ "url": "https://example.com", "errorCorrectionLevel": "H" // High error correction (30%) }

Custom Size

{ "url": "https://example.com", "width": 500 // 500x500 pixels }

šŸ¤ Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add some AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

šŸ“„ License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

šŸ‘¤ Author

Xingyu Chen

šŸ™ Acknowledgments

šŸ“š Resources

ā­ If you find this project useful, please consider giving it a star on GitHub!

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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.

  1. āœØ Features
    1. šŸ“¦ Installation
      1. Via npm (Global)
      2. Via npm (Local Project)
      3. From Source
    2. šŸš€ Quick Start
      1. Option 1: Use Remote Service (Recommended for Quick Testing) šŸŒ
      2. Option 2: Run Your Own Local Server
      3. 3. Use the Tool
    3. šŸ”§ API Reference
      1. Tool: url_to_qrcode
    4. šŸŒ HTTP Endpoints
      1. GET /
      2. GET /health
      3. POST /mcp
      4. GET /qrcodes/:filename
    5. āš™ļø Configuration
      1. šŸ—ļø Project Structure
        1. šŸ”’ Session Management
          1. šŸŒ Deployment Options
            1. Remote Service (Production)
            2. Local Deployment
          2. šŸ“ Examples
            1. Basic Usage
            2. Custom Error Correction
            3. Custom Size
          3. šŸ¤ Contributing
            1. šŸ“„ License
              1. šŸ‘¤ Author
                1. šŸ™ Acknowledgments
                  1. šŸ“š Resources

                    New MCP Servers

                    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/guangxiangdebizi/URL2QR-MCP'

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