AI导哈

二维码生成服务

一个基于MCP协议的服务器，用于从URL生成二维码，支持与Q CLI和cao supervisor工作流集成。

  • by pandson7
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 pandson7/qrcode-mcp-server

使用说明

二维码生成器MCP服务器

MCP（模型上下文协议）服务器，从URL生成二维码，与Q CLI和cao主管工作流集成。

特性

  • 从任何URL生成二维码
  • 返回base64编码的PNG图像
  • 可配置的二维码大小和边框
  • 与Q CLI代理无缝集成
  • 通过Q CLI实现自动流程管理

先决条件

  • Linux/WSL环境
  • Python 3.12+
  • Q CLI已安装并配置
  • 曹主管工作流程设置

安装和设置

1.安装系统依赖项

sudo apt update
sudo apt install -y python3-pip python3.12-venv build-essential

2.设置虚拟环境

# Navigate to the qrcode_mcp_server directory
cd qrcode_mcp_server

# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

3.测试安装

# Test the QR code generation
python test_mcp.py

# Should output:
# ✓ URL: https://wikipedia.org
# ✓ Base64 length: 764 characters
# ✓ QR code saved to 'test_qr_mcp.png'
# ✓ Test completed successfully!

4.配置Q CLI代理

添加到您的主管代理配置(supervisor.md):

mcpServers:
  qrcode-mcp-server:
    type: stdio
    command: /absolute/path/to/qrcode_mcp_server/venv/bin/python
    args:
      - "/absolute/path/to/qrcode_mcp_server/server.py"

allowedTools: ["@qrcode-mcp-server", "other-tools..."]

重要：替换 /absolute/path/to/ 使用您的实际工作空间路径。

可用工具

@qrcode-mcp-server/generate_qr_code

参数：

  • url （必填）：要在二维码中编码的URL
  • size （可选）：二维码的盒子大小，默认为10
  • border （可选）：框中的边框大小，默认值为4

Agent中的示例用法

# Agent can call:
generate_qr_code(
    url="https://github.com/your-repo",
    size=10,
    border=4
)

与曹主管整合

二维码MCP服务器作为cao主管工作流程的第一步进行集成：

  1. 项目初始化和二维码生成
    • 创建项目目录
    • 为GitHub仓库生成二维码
    • 将二维码保存为PNG文件

文件结构

qrcode_mcp_server/
├── server.py              # Main MCP server
├── test_mcp.py            # Test script
├── requirements.txt       # Python dependencies
├── README.md             # This file
├── venv/                 # Virtual environment
└── qr-code/test_qr_mcp.png      # Test output (generated)

输出文件

在项目中使用时，生成：

  • qr-code.png -二维码图像文件

故障排除

权限问题

chmod +x server.py

路径问题

  • 在代理配置中始终使用绝对路径
  • 验证虚拟环境路径是否存在

依赖关系检查

source venv/bin/activate
pip list | grep -E "(mcp|qrcode|Pillow)"

直接测试MCP服务器

source venv/bin/activate
python server.py
# Should start without errors

技术细节

  • 协议：模型上下文协议（MCP）v2024-11-05
  • 沟通：stdin/stdout JSON-RPC
  • 图像格式：采用base64编码的PNG
  • 二维码库：枕式qrcode[pil]
  • 错误纠正：L级（低）

依赖项

  • mcp>=1.0.0 -模型上下文协议框架
  • qrcode[pil]>=7.4.2 -支持PIL的二维码生成
  • Pillow>=10.4.0 -图像处理库

许可证

echo架构师编排器项目的一部分。

相关 MCP