io.github.WimSuenens/gs1belu-mpm-download

السجل الرسمي أخرى

Unofficial MCP tool surface for GS1 Belgium & Luxembourg's My Product Manager Download API (v17).

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package gs1belu-mpm-download-mcp
Claude Code
claude mcp add gs1belu-mpm-download -e 'GS1BELU_ENVIRONMENT=<GS1BELU_ENVIRONMENT>' -e 'GS1BELU_API_VERSION=<GS1BELU_API_VERSION>' -e 'GS1BELU_DOWNLOAD_CLIENT_ID=<GS1BELU_DOWNLOAD_CLIENT_ID>' -e 'GS1BELU_DOWNLOAD_CLIENT_SECRET=<your gs1belu_download_client_secret>' -e 'GS1BELU_DOWNLOAD_SUBSCRIPTION_KEY=<your gs1belu_download_subscription_key>' -- uvx gs1belu-mpm-download-mcp==0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "gs1belu-mpm-download": {
            "command": "uvx",
            "args": [
                "gs1belu-mpm-download-mcp==0.2.0"
            ],
            "env": {
                "GS1BELU_ENVIRONMENT": "<GS1BELU_ENVIRONMENT>",
                "GS1BELU_API_VERSION": "<GS1BELU_API_VERSION>",
                "GS1BELU_DOWNLOAD_CLIENT_ID": "<GS1BELU_DOWNLOAD_CLIENT_ID>",
                "GS1BELU_DOWNLOAD_CLIENT_SECRET": "<your gs1belu_download_client_secret>",
                "GS1BELU_DOWNLOAD_SUBSCRIPTION_KEY": "<your gs1belu_download_subscription_key>"
            }
        }
    }
}

متغيرات البيئة

  • GS1BELU_ENVIRONMENT إلزامي Target environment: uat or prod.
  • GS1BELU_API_VERSION API contract version segment (default v17).
  • GS1BELU_DOWNLOAD_CLIENT_ID إلزامي Download API OAuth2 client-credentials client id.
  • GS1BELU_DOWNLOAD_CLIENT_SECRET إلزامي سري Download API OAuth2 client-credentials client secret.
  • GS1BELU_DOWNLOAD_SUBSCRIPTION_KEY إلزامي سري Download API Ocp-Apim-Subscription-Key.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. gs1belu.myproductmanager
  2. Artifacts
  3. Monorepo map
  4. Contributing
  5. License

gs1belu.myproductmanager

Generated C#/TypeScript SDKs and an MCP server for the GS1 Belgium & Luxembourg "My Product Manager" REST APIs (Upload + Download, v17), built from the vendor OpenAPI schemas under schemas/.

[!IMPORTANT] Unofficial. This project is a community effort and is not affiliated with, endorsed by, or supported by GS1 in any way. "GS1" and "My Product Manager" are the property of their respective owners. Use at your own risk.

Artifacts

Four artifacts are generated from the same source schemas. None are published yet — the links below are where each will land. Per-package READMEs carry the real quickstart for each.

ArtifactLanguageConsume viaSource
C# SDK.NETNuGet — dotnet add package … (coming soon)sdks/ → dotnet/
TypeScript SDKTS/JSnpm — @gs1belu/mpm-upload, @gs1belu/mpm-fetch (coming soon)sdks/ → typescript/
Upload MCP serverPythonuvx gs1belu-mpm-upload-mcp / the MCP registry (coming soon)mcp/upload/
Download MCP serverPythonuvx gs1belu-mpm-download-mcp / the MCP registry (coming soon)mcp/download/

The two SDKs are generated with Kiota (one client per API document, never merged). The two MCP servers build their tools at runtime with FastMCP — no code generation — and are independent, single-role processes (map #82): a data-supplier installs only the Upload server, a data-recipient only the Download one. mcp/combined/ is their deprecated, pre-split predecessor — see its README for the migration guide.

Monorepo map

schemas/     Vendor OpenAPI specs + overlays — the single source of truth
  upload/    · download/   (each: v17.yaml vendor original, v17.json, v17.overlay.yaml)
sdks/        The two Kiota SDKs (dotnet/, typescript/)
mcp/         The FastMCP MCP servers (Python): shared/, upload/, download/, and the
             deprecated combined/
scripts/     Schema-prep build + tests, driven by the justfile
docs/        ADRs, research, manuals, the schema-ingestion runbook
justfile     Task front door — `just gen` / `just build` / `just test`

The project's ubiquitous language (pristine vendor original, overlay, effective spec, dead patch) is defined in CONTEXT.md; the decisions behind the layout are in docs/adr/.

Contributing

See CONTRIBUTING.md for the toolchain prerequisites, the schema-editing rule, and the PR flow. The one rule that must never be broken: never hand-edit a vendor schema or generated code — correct it through the overlay and regenerate.

License

MIT.

الأسئلة الشائعة

ما هو io.github.WimSuenens/gs1belu-mpm-download؟

Unofficial MCP tool surface for GS1 Belgium & Luxembourg's My Product Manager Download API (v17).

كيف أثبّت io.github.WimSuenens/gs1belu-mpm-download؟

يعمل على جهازك. في Claude Code: claude mcp add gs1belu-mpm-download -e 'GS1BELU_ENVIRONMENT=<GS1BELU_ENVIRONMENT>' -e 'GS1BELU_API_VERSION=<GS1BELU_API_VERSION>' -e 'GS1BELU_DOWNLOAD_CLIENT_ID=<GS1BELU_DOWNLOAD_CLIENT_ID>' -e 'GS1BELU_DOWNLOAD_CLIENT_SECRET=<your gs1belu_download_client_secret>' -e 'GS1BELU_DOWNLOAD_SUBSCRIPTION_KEY=<your gs1belu_download_subscription_key>' -- uvx gs1belu-mpm-download-mcp==0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.WimSuenens/gs1belu-mpm-download إلى مفتاح API؟

نعم. يتطلب GS1BELU_ENVIRONMENT, GS1BELU_DOWNLOAD_CLIENT_ID, GS1BELU_DOWNLOAD_CLIENT_SECRET, GS1BELU_DOWNLOAD_SUBSCRIPTION_KEY، وتضبطها في إعداداته.

هل io.github.WimSuenens/gs1belu-mpm-download مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.WimSuenens/gs1belu-mpm-download؟

ينشره WimSuenens. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.