ODDWOOD Barcode Tool

io.github.oddwood-xv1.0.0更新于 Oct 5, 2026

Paid MCP server for EAN, UPC, and GTIN validation, normalization, correction, and batch analysis.

已验证Streamable HTTP可网页运行Data & AnalyticsBusiness & Commerce

概览

AI 生成的概览

通过付费远程 MCP 端点校验、规范化并批量分析 EAN、UPC 和 GTIN 条码。

功能
提供两个工具：analyze_barcode 可识别条码类型、校验 GTIN 校验位、报告期望值与实际值、给出修正后的条码建议，并规范化为 GTIN-14；analyze_barcode_batch 每次请求最多处理 100,000 个条码，支持重复检测、可选去重、错误与类型统计，并输出 full、errors_only 或 summary 三种结果。前导零会被保留，规范化时可安全去除空格和连字符并返回警告。
适用场景
适合需要检查或清理大量商品编码、又不想让模型把推理花在校验位计算上的场景，例如校验目录导出数据、对条码列表去重，或在导入前修正无效校验位。
运行要求
使用远程 streamable HTTP MCP 端点；托管服务无需本地运行时或安装包。每次工具调用通过 x402 支付协议以 Base 网络上的 USDC 付费，因此需要兼容 x402 的客户端和已充值的钱包。README 也说明了本地运行所需的 Node.js 24+ 与 npm 环境。
安装前请注意
这是付费服务：analyze_barcode 每次调用 0.001 USDC，analyze_barcode_batch 每次 0.003 USDC，由 x402 客户端自动结算，支出取决于调用量。README 说明该服务只处理条码值、不需要个人信息，并提醒不要把机密、凭据、私钥或访问令牌作为条码输入提交。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ODDWOOD Barcode Tool，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "barcode-tool": {
      "type": "http",
      "url": "https://barcode-tool.fly.dev/mcp"
    }
  }
}

README

ODDWOOD Barcode Tool

A paid MCP tool for deterministic barcode validation, normalization, and batch analysis.

Built for AI agents and automated workflows that need reliable EAN, UPC, and GTIN processing without spending model reasoning on checksum calculations or large barcode datasets.

Public MCP Endpoint

text
https://barcode-tool.fly.dev/mcp

Transport: Streamable HTTP MCP
Payment: x402
Network: Base
Currency: USDC

Supported Barcode Types

  • EAN-8
  • UPC-A
  • EAN-13
  • GTIN-14

Leading zeros are preserved.

Spaces and hyphens can be safely removed during normalization, with a warning returned in the result.

Tools

analyze_barcode

Validates and analyzes a single barcode.

Price: $0.001 USDC per call

Capabilities:

  • Barcode type recognition
  • GTIN check digit validation
  • Expected vs. actual check digit reporting
  • Corrected barcode suggestion for invalid check digits
  • Detection of unambiguous missing check digits
  • GTIN-14 normalization
  • Safe formatting cleanup
  • Structured errors and warnings

Example input:

json
{  "barcode": "036000291452"}

Example result:

json
{  "input": "036000291452",  "cleanedInput": "036000291452",  "type": "UPC-A",  "valid": true,  "error": null,  "warnings": [],  "actualCheckDigit": 2,  "expectedCheckDigit": 2,  "correctedBarcode": null,  "gtin14": "00036000291452"}

analyze_barcode_batch

Validates and analyzes up to 100,000 barcodes in one request.

Price: $0.003 USDC per call

Capabilities:

  • Batch validation
  • Duplicate detection
  • Optional deduplication
  • Error statistics
  • Barcode type statistics
  • Internal chunk processing
  • Configurable result limits
  • Selective result filtering

Output modes:

  • full
  • errors_only
  • summary

Results can be filtered by:

  • Validity
  • Barcode type
  • Validation error type

Supported validation error types:

  • invalid_check_digit
  • missing_check_digit
  • invalid_length
  • invalid_characters
  • empty_input
  • other

The maximum batch size is 100,000 barcodes.

The default detailed result limit is 10,000 records, with a hard maximum of 50,000 detailed results.

x402 Payments

Tool calls use the x402 payment protocol.

Payments use USDC on Base.

ToolPrice
analyze_barcode$0.001 USDC
analyze_barcode_batch$0.003 USDC

Payment is handled automatically by x402-compatible clients.

Health Endpoint

text
https://barcode-tool.fly.dev/health

The health endpoint reports service status, configured network, payment receiver, and current tool prices.

Privacy

The service is designed to process barcode values and does not require personal information.

Do not submit secrets, credentials, private keys, access tokens, or other sensitive information as barcode input.

Development

Requirements:

  • Node.js 24+
  • npm

Install dependencies:

bash
npm install

Run the local stdio MCP server:

bash
node server.js

Run the free local HTTP MCP server:

bash
node remote-server.js

Run the x402-enabled server:

bash
node paid-server.js

Run tests:

bash
node test.jsnode filter-test.jsnode stress-test.js

License

ISC

Developer

ODDWOOD

来源：README.md，提交 5c47f71

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Oct 5, 2026