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