Skip to main content
Glama
deenesjakoptruzh
vertexdevs-hq

gs1br

by vertexdevs-hq
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

mcp-gs1br

用于 GS1 Brasil — Verified by GS1 API 的 Model Context Protocol (MCP) 服务器。

通过 GTIN（EAN-8、UPC-A、EAN-13、ITF-14）查询产品的权威数据：品牌、描述、GPC、NCM、CEST、图片、重量、尺寸、授权方。覆盖国内数据库（Cadastro Nacional de Produtos – CNP）和国际数据库（GS1 Registry Platform）。

先决条件

  1. 成为 GS1 Brasil 的会员。

  2. 在 https://verifiedbygs1.gs1br.org/ 接受使用条款。

  3. 在 https://fs8.formsite.com/gsurvey/cfw75k23hq/index 申请访问权限。

  4. 从 GS1 Brasil 获取您的 client_id 和 client_secret。

之后，您使用 CNP / Verified by GS1 门户的相同 username/password 作为 OAuth 凭据。

安装

cd mcp-gs1br
npm install
npm run build

配置

将凭据导出为环境变量：

Variável

Obrigatória

Descrição

GS1BR_CLIENT_ID

是

从 GS1 Brasil 收到的 Client ID

GS1BR_CLIENT_SECRET

是

从 GS1 Brasil 收到的 Client Secret

GS1BR_USERNAME

是

CNP / Verified by GS1 用户的电子邮件

GS1BR_PASSWORD

是

同一用户的密码

GS1BR_ENV

否

production（默认）或 homologacao

在 Claude Code 中注册为 MCP

.claude/mcp.json 或等效文件：

{
  "mcpServers": {
    "gs1br": {
      "command": "node",
      "args": ["/caminho/absoluto/para/mcp-gs1br/dist/index.js"],
      "env": {
        "GS1BR_CLIENT_ID": "...",
        "GS1BR_CLIENT_SECRET": "...",
        "GS1BR_USERNAME": "seu@email",
        "GS1BR_PASSWORD": "...",
        "GS1BR_ENV": "production"
      }
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "gs1br": {
      "command": "node",
      "args": ["/caminho/absoluto/para/mcp-gs1br/dist/index.js"],
      "env": { "GS1BR_CLIENT_ID": "...", "GS1BR_CLIENT_SECRET": "...", "GS1BR_USERNAME": "...", "GS1BR_PASSWORD": "..." }
    }
  }
}

暴露的工具

gs1_validate_check_digit

在本地验证 GTIN 的校验位（模 10）。不消耗 API。适用于在消耗配额之前过滤不良读取。

{ "gtin": "7898357416086" }

gs1_verify_gtin

查询一个 GTIN 并返回规范化摘要：

{
  "gtin": "7898357416086",
  "found": true,
  "source": "national",
  "status": "Válido",
  "brand": "GS1 Brasil",
  "description": "GS1 Brasil Tênis de Corrida Style Azul com Branco Tamanho 37",
  "gpcCategoryCode": "10001070",
  "gpcCategoryName": "Calçados Esportivos - Uso Geral",
  "ncm": "0000.00.00",
  "cest": "28.059.00",
  "imageUrls": ["https://cnp30blob.blob.core.windows.net/cnp3files/..."],
  "grossWeight": { "value": 2.8, "unitCode": "KGM" },
  "netWeight":   { "value": 2.8, "unitCode": "KGM" },
  "netContent":  { "value": 1,   "unitCode": "EA"  },
  "dimensions": {
    "height": { "value": 40, "unitCode": "CMT" },
    "width":  { "value": 17, "unitCode": "CMT" },
    "depth":  { "value": 10, "unitCode": "CMT" }
  },
  "licensee": {
    "name": "GS1 BRASIL - ASSOCIACAO BRASILEIRA DE AUTOMACAO",
    "licenseType": "GCP",
    "managingOrganization": "GS1 Brasil"
  },
  "syncInformationCCG": true,
  "raw": { ... }
}

根据所签约的查询配置文件（Verificação、Verificação + Nacional、Verificação + Internacional、Nacional + Internacional），字段可能为空。

gs1_verify_gtin_raw

与上述相同，但返回 GS1 API 的原始 JSON（包含 dadosInternacionais、dadosNacionais、verificacao 的数组）。

gs1_enrich_many

按顺序丰富最多 25 个 GTIN 的批次。在本地过滤无效的校验位以节省请求。

{ "gtins": ["7898357416086", "4006381333931", "..."] }

底层实现

  • OAuth 2.0 password grant，针对 POST {host}/oauth/access-token，请求头 Authorization: Basic base64(client_id:client_secret)，请求体 JSON {grant_type, username, password}。

  • 内存中的令牌缓存，TTL 3 小时（expires_in = 10800）。在 401/403 时自动重新认证。

  • 查询：GET {host}/provider/v2/verified?gtin={GTIN}，带有 client_id 和 access_token 请求头。

  • 主机：

    • https://api.gs1br.org（生产）

    • https://api-hml.gs1br.org（预发布）

常见错误

Código HTTP

Situação

200

成功

400

无效请求

403

用户无权访问该资源

404

未找到 GTIN

500

GS1 内部错误

当 GTIN 为国际时，负载内返回的业务代码（returnCode / returnCodeDescription）——参见官方手册 R1.3。

参考

许可证

MIT.

This server cannot be installed

-
license - not tested
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Bling

    Bling ERP (SMB and e-commerce management, by Locaweb) via the official v3 API, sales orders, product

  • TracePass

    Manage products, EU Digital Product Passports, operator parties, and GS1 EPCIS supply-chain events.

  • Correios: CEP

    Correios: CEP, official-source lookup. Platform-hosted, pay per query with prepaid credit.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vertexdevs-hq/mcp-gs1br'

If you have feedback or need assistance with the MCP directory API, please join our Discord server