Issuebage MCP Server

आधिकारिक

डिजिटल बैज जारी करने का प्लेटफॉर्म

Issuebage MCP के साथ आप क्या कर सकते हैं?

API कुंजी सत्यापित करें — सहायक से validate_key का उपयोग करके जाँच करवाएँ कि आपकी IssueBadge API कुंजी मान्य है या नहीं।
बैज टेम्पलेट सूचीबद्ध करें — सहायक से get_all_badges के माध्यम से आपके सभी उपलब्ध बैज टेम्पलेट प्राप्त करवाएँ।
प्रमाणपत्र जारी करें — सहायक से issue_badge का उपयोग करके किसी प्राप्तकर्ता को नाम और ईमेल द्वारा प्रमाणपत्र भेजने का अनुरोध करें।
नए बैज बनाएँ (केवल स्थानीय) — सहायक को निर्देश दें कि स्थानीय रूप से चलाते समय create_badge के साथ एक नया बैज टेम्पलेट परिभाषित करें।

दस्तावेज़

IssueBadge MCP सर्वर

किसी भी AI एजेंट से सत्यापन योग्य प्रमाणपत्र और बैज जारी करें। यह मॉडल कॉन्टेक्स्ट प्रोटोकॉल सर्वर Cursor, Claude, VS Code और अन्य MCP क्लाइंट्स को आपके IssueBadge बैज टेम्पलेट्स की सूची देखने और नाम तथा ईमेल द्वारा प्राप्तकर्ता को प्रमाणपत्र भेजने की सुविधा देता है।

इसे चलाने के दो तरीके:

	रिमोट (अनुशंसित)	लोकल (stdio)
एंडपॉइंट	`https://issuebadge-mcp.issuebadge.workers.dev/mcp`	`npx issuebadge-mcp-server`
प्रमाणीकरण	`Authorization: Bearer <API key>` हेडर	`ISSUEBADGE_API_KEY` env वेरिएबल
टूल्स	`validate_key`, `get_all_badges`, `issue_badge`	वही + `create_badge`
स्टोरेज	कोई नहीं, स्टेटलेस	कोई नहीं

आपको IssueBadge API कुंजी चाहिए: app.issuebadge.com → डेवलपर → API कुंजी (https://app.issuebadge.com/developer/index)।

इंस्टॉल करें

Cursor

Cursor मार्केटप्लेस से IssueBadge इंस्टॉल करें और संकेत मिलने पर अपनी API कुंजी पेस्ट करें। या इसे सेटिंग्स → MCP में हाथ से जोड़ें:

{
  "mcpServers": {
    "issuebadge": {
      "type": "streamable-http",
      "url": "https://issuebadge-mcp.issuebadge.workers.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_ISSUEBADGE_API_KEY" }
    }
  }
}

Claude Code

claude mcp add --transport http issuebadge https://issuebadge-mcp.issuebadge.workers.dev/mcp \
  --header "Authorization: Bearer YOUR_ISSUEBADGE_API_KEY"

यह रिपॉजिटरी एक Claude Code प्लगइन (.claude-plugin/plugin.json) भी है और एक issuebadge स्किल के साथ आती है जो एजेंट को सूची → पुष्टि → जारी करने का वर्कफ़्लो सिखाती है। प्लगइन का .mcp.json कुंजी को ISSUEBADGE_API_KEY पर्यावरण वेरिएबल से पढ़ता है, इसलिए Claude Code शुरू करने से पहले इसे एक्सपोर्ट करें।

Claude Desktop / कोई भी stdio क्लाइंट

{
  "mcpServers": {
    "issuebadge": {
      "command": "npx",
      "args": ["-y", "issuebadge-mcp-server"],
      "env": { "ISSUEBADGE_API_KEY": "YOUR_ISSUEBADGE_API_KEY" }
    }
  }
}

VS Code (Copilot एजेंट मोड)

.vscode/mcp.json:

{
  "servers": {
    "issuebadge": {
      "type": "http",
      "url": "https://issuebadge-mcp.issuebadge.workers.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_ISSUEBADGE_API_KEY" }
    }
  }
}

टूल्स

टूल	इनपुट	रिटर्न
`validate_key`	–	`{ valid, message }`
`get_all_badges`	`limit?`	`{ badges: [{ id, name, description?, created_at? }] }`
`issue_badge`	`badge_id`, `name`, `email?`, `phone?`, `idempotency_key?`, `metadata?`	`{ issue_id, certificate_url, idempotency_key }`
`create_badge` (केवल stdio)	`name`, `description`, `issuing_organization_name`, `idempotency_key`, वैकल्पिक `badge_logo_path`, `custom_fields`, …	IssueBadge API प्रतिक्रिया

issue_badge प्रमाणपत्र को प्राप्तकर्ता को ईमेल करता है और एक सार्वजनिक सत्यापन URL लौटाता है। नए idempotency_key के साथ हर कॉल एक नया प्रमाणपत्र जारी करती है (यदि आप इसे छोड़ देते हैं तो एक mcp-<uuid> के रूप में उत्पन्न होता है)। API पुनः उपयोग की गई कुंजी को अस्वीकार करता है, इसलिए असफल कॉल के बाद जाँचें कि क्या प्रमाणपत्र जारी हुआ था, फिर नई कुंजी के साथ दोबारा कॉल करें।

इंस्टॉल होने के बाद उदाहरण प्रॉम्प्ट: "जेन डो, jane@example.com को कोर्स पूर्णता प्रमाणपत्र जारी करें।"

ChatGPT और OAuth

रिमोट सर्वर उन होस्ट्स के लिए OAuth 2.1 भी बोलता है जो API कुंजी नहीं भेज सकते (ChatGPT ऐप्स, Claude कनेक्टर): बिना बियरर के अनुरोध को 401 + WWW-Authenticate: Bearer resource_metadata=… मिलता है, /.well-known/oauth-protected-resource https://app.issuebadge.com की ओर इशारा करता है (PKCE S256, डायनामिक क्लाइंट पंजीकरण), और जारी किया गया एक्सेस टोकन बिल्कुल API कुंजी की तरह आगे भेजा जाता है। issue_badge एक विजेट (ui://widget/certificate.html, MCP ऐप्स / ChatGPT ऐप्स SDK) रखता है जो प्रमाणपत्र कार्ड प्रस्तुत करता है। CHATGPT.md देखें।

गोपनीयता और सुरक्षा

रिमोट सर्वर स्टेटलेस है। आपकी API कुंजी प्रत्येक अनुरोध के Authorization हेडर से पढ़ी जाती है, app.issuebadge.com को आगे भेजी जाती है, और कभी संग्रहीत या लॉग नहीं की जाती। बिना कुंजी वाले अनुरोधों को 401 मिलता है।
संपर्क किया गया एकमात्र होस्ट app.issuebadge.com है। प्रमाणपत्र बनाने के लिए प्राप्तकर्ता का नाम, ईमेल और बैज आईडी वहाँ भेजे जाते हैं।
गोपनीयता नीति: https://issuebadge.com/h/policy · शर्तें: https://issuebadge.com/h/terms · सहायता: https://issuebadge.com/h/contact

रिमोट सर्वर को सेल्फ-होस्ट करें

git clone https://github.com/issuebadge/mcp-server && cd mcp-server
npm install
npm test
npx wrangler deploy --config worker/wrangler.toml   # needs a Cloudflare account

GET /health { ok: true } लौटाता है। यदि आप IssueBadge कहीं और चलाते हैं तो stdio सर्वर के लिए ISSUEBADGE_BASE_URL को एक अलग API होस्ट पर इंगित करें।

विकास

npm install
npm test          # vitest: client, tools, worker (mocked IssueBadge API)
npm run build     # tsc → dist/ (stdio bin)
npm run dev:worker

लेआउट: src/issuebadge.ts (API क्लाइंट), src/tools.ts (दोनों होस्ट्स द्वारा साझा टूल रजिस्ट्री), src/stdio.ts (npm bin), src/createBadge.ts (केवल stdio टूल), worker/index.ts (Cloudflare वर्कर), .cursor-plugin/ + mcp.json (Cursor प्लगइन), .claude-plugin/ + .mcp.json (Claude Code प्लगइन), skills/issuebadge/SKILL.md, server.json (MCP रजिस्ट्री)।

लाइसेंस

MIT