AI导哈

二维码扫描工具包

基于FastMCP框架的二维码扫描工具包，支持从单个或多个图片URL扫描二维码，适用于二维码识别和处理场景。

  • by pidanmeng
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 pidanmeng/mcp-scan-qr

使用说明

mcp-scan-qr

这是一个基于 FastMCP 框架构建的 MCP (Model Context Protocol) 工具包，用于从图像中扫描二维码。

功能

当前实现了以下二维码扫描工具：

  • scanQRCode: 从单个图片URL扫描二维码
  • scanQRCodeBatch: 从多个图片URL批量扫描二维码

安装依赖

bun install

运行项目

bun run dev

调试项目

bun run inspect

构建项目

bun run build

部署 MCP

{
  "mcpServers": {
    "mcp-scan-qr": {
      "args": ["-y","@pidanmoe/mcp-scan-qr"],
      "command": "npx",
      "env": {
        // 环境变量
      }
    }
  }
}

项目结构

  • [src/index.ts](file:///Volumes/SSD/_work/mcp-template/mcp-scan-qr/src/index.ts): 主入口文件，初始化并启动 FastMCP 服务器
  • [src/tools/scanQRCode.ts](file:///Volumes/SSD/_work/mcp-template/mcp-scan-qr/src/tools/scanQRCode.ts): 实现了 scanQRCode 工具，支持从单个图片URL扫描二维码
  • [src/tools/scanQRCodeBatch.ts](file:///Volumes/SSD/_work/mcp-template/mcp-scan-qr/src/tools/scanQRCodeBatch.ts): 实现了 scanQRCodeBatch 工具，支持从多个图片URL批量扫描二维码
  • [src/utils/logger.ts](file:///Volumes/SSD/_work/mcp-template/mcp-scan-qr/src/utils/logger.ts): 日志工具模块

使用说明

该工具包提供了两个MCP工具：

scanQRCode

从单个HTTPS图片URL扫描二维码：

{
  "name": "scanQRCode",
  "arguments": {
    "imageUrl": "https://example.com/qrcode.png"
  }
}

scanQRCodeBatch

从多个HTTPS图片URL批量扫描二维码（最多10个）：

{
  "name": "scanQRCodeBatch",
  "arguments": {
    "imageUrls": [
      "https://example.com/qrcode1.png",
      "https://example.com/qrcode2.png"
    ]
  }
}

两个工具都会返回包含扫描结果的JSON字符串。成功时返回二维码内容，失败时返回错误信息。

技术栈

  • Bun - JavaScript/TypeScript 运行时
  • FastMCP - MCP 框架
  • Zod - TypeScript-first schema declaration and validation library
  • jsQR - JavaScript QR code reader
  • Sharp - High performance Node.js image processing
  • Axios - Promise based HTTP client

此项目使用 bun v1.2.19 创建。Bun 是一个快速的一体化 JavaScript 运行时。

相关 MCP