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»).
gs1belu-mpm-download-mcpclaude 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
{
"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_VERSIONAPI 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.
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.
| Artifact | Language | Consume via | Source |
|---|---|---|---|
| C# SDK | .NET | NuGet — dotnet add package … (coming soon) | sdks/ → dotnet/ |
| TypeScript SDK | TS/JS | npm — @gs1belu/mpm-upload, @gs1belu/mpm-fetch (coming soon) | sdks/ → typescript/ |
| Upload MCP server | Python | uvx gs1belu-mpm-upload-mcp / the MCP registry (coming soon) | mcp/upload/ |
| Download MCP server | Python | uvx 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.