ODDWOOD Barcode Tool

ODDWOOD 条码工具

一款付费 MCP 工具，用于确定性条码验证、规范化和批量分析。

专为需要可靠处理 EAN、UPC 和 GTIN 的 AI Agent 与自动化工作流打造，无需耗费大模型推理能力来计算校验位或处理大型条码数据集。

公共 MCP 端点

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

传输方式： Streamable HTTP MCP
支付方式： x402
网络： Base
货币： USDC

支持的条码类型

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

保留前导零。

规范化时可安全移除空格和连字符，结果中会返回警告。

工具

analyze_barcode

验证并分析单个条码。

价格： 每次调用 $0.001 USDC

功能：

• 条码类型识别
• GTIN 校验位验证
• 报告预期校验位与实际校验位
• 为校验位无效的条码提供更正建议
• 检测可明确判断缺失校验位的情况
• GTIN-14 规范化
• 安全清理格式
• 结构化错误和警告

输入示例：

{
  "barcode": "036000291452"
}

结果示例：

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

---

analyze_barcode_batch

在单个请求中验证并分析多达 100,000 个条码。

价格： 每次调用 $0.003 USDC

功能：

• 批量验证
• 重复项检测
• 可选去重
• 错误统计
• 条码类型统计
• 内部分块处理
• 可配置结果数量上限
• 按条件筛选结果

输出模式：

• full
• errors_only
• summary

可按以下条件筛选结果：

• 有效性
• 条码类型
• 验证错误类型

支持的验证错误类型：

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

批次大小上限为 100,000 个条码。

详细结果的默认数量上限为 10,000 条记录，硬性上限为 50,000 条详细结果。

x402 支付

工具调用使用 x402 支付协议。

支付使用 Base 上的 USDC。

工具	价格
analyze_barcode	$0.001 USDC
analyze_barcode_batch	$0.003 USDC

支付由兼容 x402 的客户端自动处理。

健康检查端点

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

健康检查端点会报告服务状态、配置的网络、收款方以及当前工具价格。

隐私

本服务专为处理条码值而设计，无需个人信息。

请勿将机密信息、凭据、私钥、访问令牌或其他敏感信息作为条码输入提交。

开发

要求：

• Node.js 24+
• npm

安装依赖：

npm install

运行本地 stdio MCP 服务：

node server.js

运行免费的本地 HTTP MCP 服务：

node remote-server.js

运行启用 x402 的服务：

node paid-server.js

运行测试：

node test.js
node filter-test.js
node stress-test.js

许可证

ISC

开发者

ODDWOOD