MCP Server Qrcode Enhanced

增强型二维码MCP服务器

一种增强的模型上下文协议（MCP）服务器，用于高级二维码生成和处理，灵感来自并扩展 @jwalsh/mcp服务器qrcode.

🙏 归因

该项目建立在 @jwalsh/mcp服务器qrcode。我们感谢原作者创建了启发这些增强功能的基本QR码MCP服务器。

✨ 增强功能

除了原始的二维码生成功能外，此增强版本还增加了：

🚀 高级二维码生成

• 自定义样式：徽标嵌入、自定义颜色、圆角
• 多种格式：PNG、SVG、PDF输出支持
• 批量处理：同时生成多个二维码
• 模板系统：用于常见用例的预定义二维码模板

📊 智能内容检测

• URL验证：自动验证和优化URL
• 联系人卡片：根据联系信息生成vCard二维码
• WiFi凭据：创建WiFi网络二维码
• 事件详细信息：生成日历事件二维码

🔍 二维码分析

• 解码现有二维码：从二维码图像中提取内容
• 质量评价：分析二维码可读性和优化
• 格式检测：识别二维码内容类型

📈 分析和跟踪

• 使用统计：跟踪二维码生成模式
• 性能指标：监控服务器性能和响应时间
• 导出功能：生成报告和分析

🛠 安装

# Clone the repository
git clone https://github.com/myownipgit/mcp-server-qrcode-enhanced.git
cd mcp-server-qrcode-enhanced

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

🔧 配置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "qrcode-enhanced": {
      "command": "node",
      "args": ["path/to/mcp-server-qrcode-enhanced/dist/index.js"],
      "env": {
        "QR_OUTPUT_DIR": "./qr-codes",
        "QR_DEFAULT_SIZE": "300",
        "QR_DEFAULT_ERROR_CORRECTION": "M"
      }
    }
  }
}

📋 可用工具

基本二维码生成

• generate_qr_basic -简单的二维码生成
• generate_qr_styled -自定义样式的二维码
• generate_qr_batch -生成多个二维码

专用二维码

• generate_vcard_qr -联系卡二维码
• generate_wifi_qr -WiFi网络二维码
• generate_event_qr -日历活动二维码

分析与处理

• decode_qr_image -从二维码图像中提取内容
• analyze_qr_quality -评估二维码质量
• optimize_qr_content -优化二维码内容

模板和实用程序

• list_qr_templates -可用的二维码模板
• get_qr_statistics -使用和性能统计
• validate_qr_content -生成前验证内容

📖 使用示例

生成样式化的二维码

const result = await generateStyledQR({
  content: "https://example.com",
  style: {
    foregroundColor: "#000000",
    backgroundColor: "#ffffff",
    logoPath: "./logo.png",
    cornerRadius: 10
  },
  format: "png",
  size: 400
});

创建WiFi二维码

const wifiQR = await generateWiFiQR({
  ssid: "MyNetwork",
  password: "MyPassword",
  security: "WPA2",
  hidden: false
});

解码现有的二维码

const decoded = await decodeQRImage({
  imagePath: "./qr-code.png",
  outputFormat: "json"
});

🤝 贡献

欢迎投稿！请随时提交拉取请求。确保：

1. 遵循现有代码样式
2. 为新功能添加测试
3. 根据需要更新文档
4. 参考原件 @jwalsh/mcp服务器qrcode 在适当的时候

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🔗 相关项目

• 原始二维码MCP服务器 作者@jwalsh
• MCP规范
• MCP-SDK

📝 更新日志

v1.0.0

• 基于@jwalsh/mcp服务器qrcode的初始增强版本
• 添加了自定义样式功能
• 实施了专门的二维码类型
• 添加二维码分析工具
• 增强的错误处理和验证

______________________________________________________________________

内置于❤️ 在良好的基础之上 @jwalsh