Issuebage MCP Server

आधिकारिक

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

GitHub

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

  • API कुंजी सत्यापित करें — validate_key का उपयोग करके जांचें कि IssueBadge API कुंजी मान्य है या नहीं।
  • सभी बैज सूचीबद्ध करें — get_all_badges के माध्यम से अपने संगठन के लिए उपलब्ध बैज टेम्पलेट प्राप्त करें, वैकल्पिक रूप से संख्या सीमित करें।
  • बैज टेम्पलेट बनाएं — create_badge के ज़रिए नाम, विवरण और कस्टम फ़ील्ड के साथ एक नया बैज परिभाषित करें।
  • प्राप्तकर्ता को बैज जारी करें — issue_badge का उपयोग करके किसी व्यक्ति को नाम और ईमेल द्वारा, वैकल्पिक मेटाडेटा के साथ, मौजूदा बैज प्रदान करें।

दस्तावेज़

IssueBadge MCP सर्वर

npm version License: MIT TypeScript MCP

IssueBadge API के साथ इंटरैक्ट करने के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर। यह सर्वर Claude और ChatGPT जैसे AI सहायकों को प्राकृतिक भाषा का उपयोग करके डिजिटल बैज और प्रमाणपत्र प्रबंधित करने में सक्षम बनाता है।

🌟 विशेषताएँ

  • 🤖 AI-संचालित बैज प्रबंधन: बैज बनाने, जारी करने और प्रबंधित करने के लिए प्राकृतिक भाषा का उपयोग करें
  • 🔐 दोहरी प्रमाणीकरण: Laravel Sanctum और OAuth2 दोनों के लिए समर्थन
  • 🏆 पूर्ण बैज जीवनचक्र: टेम्पलेट बनाएँ, प्राप्तकर्ताओं को जारी करें और प्रामाणिकता सत्यापित करें
  • 📊 मल्टी-टेनेंट समर्थन: उद्यम उपयोग के लिए सुरक्षित टेनेंट पृथक्करण
  • 🛡️ निरर्थकता संरक्षण: अंतर्निहित सुरक्षा उपायों के साथ डुप्लिकेट संचालन रोकें
  • 📧 स्वचालित सूचनाएँ: सत्यापन URL के साथ स्वचालित ईमेल वितरण
  • 🎨 कस्टम फ़ील्ड: लचीला मेटाडेटा और कस्टम फ़ील्ड समर्थन

🚀 त्वरित शुरुआत

पूर्वापेक्षाएँ

  • Node.js 18+
  • npm 8+
  • API कुंजी के साथ IssueBadge API खाता

स्थापना

  1. रिपॉजिटरी क्लोन करें

    git clone https://github.com/issuebadge/mcp-server.git
cd mcp-server

  2. निर्भरताएँ स्थापित करें

    npm install

  3. एनवायरनमेंट कॉन्फ़िगर करें

    cp .env.example .env
# Edit .env with your IssueBadge API credentials

  4. प्रोजेक्ट बिल्ड करें

    npm run build

  5. सर्वर का परीक्षण करें

    npm test

⚙️ कॉन्फ़िगरेशन

.env.example पर आधारित एक .env फ़ाइल बनाएँ:

# API Configuration
ISSUEBADGE_BASE_URL=https://app.issuebadge.com/api/v1
ISSUEBADGE_API_KEY=

# OAuth2 Configuration (Alternative)
ISSUEBADGE_OAUTH_URL=https://app.issuebadge.com/api/v1/oauth
ISSUEBADGE_OAUTH_TOKEN=your_oauth_token_here

# Authentication Method (sanctum or oauth2)
AUTH_METHOD=sanctum

# Server Configuration
MCP_SERVER_NAME=IssueBadge MCP Server
MCP_SERVER_VERSION=1.0.0

# Optional Settings
REQUEST_TIMEOUT=30000
DEBUG=false
MAX_RETRIES=3
RETRY_DELAY=1000

🔧 एकीकरण

Claude Desktop

इस सर्वर को अपने Claude Desktop कॉन्फ़िगरेशन में जोड़ें:

{
  "mcpServers": {
    "issuebadge": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "ISSUEBADGE_BASE_URL": "https://app.issuebadge.com
/api/v1",
        "ISSUEBADGE_API_KEY": "",
        "AUTH_METHOD": "sanctum"
      }
    }
  }
}

ChatGPT Actions

  1. ChatGPT में एक नया कस्टम GPT बनाएँ
  2. अपने IssueBadge इंस्टेंस से OpenAPI विनिर्देश आयात करें
  3. अपनी API कुंजी के साथ Bearer टोकन प्रमाणीकरण कॉन्फ़िगर करें
  4. बातचीत के माध्यम से बैज प्रबंधित करना शुरू करें!

🛠️ उपलब्ध उपकरण

1. validate_key

प्रमाणीकरण के लिए IssueBadge API कुंजियों को मान्य करता है।

पैरामीटर:

  • api_key (स्ट्रिंग, आवश्यक): मान्य करने के लिए API कुंजी

उदाहरण:

"Validate my API key: 1|abcdef123456789..."

2. get_all_badges

प्रमाणित संगठन के लिए सभी उपलब्ध बैज प्राप्त करता है।

पैरामीटर:

  • limit (संख्या, वैकल्पिक): लौटाने के लिए अधिकतम बैज (डिफ़ॉल्ट: 100)

उदाहरण:

"Show me all available badges"
"List the first 50 badges"

3. create_badge

वैकल्पिक कस्टम फ़ील्ड के साथ एक नया बैज टेम्पलेट बनाता है।

पैरामीटर:

  • name (स्ट्रिंग, आवश्यक): बैज का नाम
  • description (स्ट्रिंग, आवश्यक): बैज का विवरण
  • issuing_organization_name (स्ट्रिंग, आवश्यक): संगठन का नाम
  • idempotency_key (स्ट्रिंग, आवश्यक): अद्वितीय पहचानकर्ता
  • custom_fields (सरणी, वैकल्पिक): कस्टम फ़ील्ड परिभाषाएँ
  • और अधिक वैकल्पिक पैरामीटर...

उदाहरण:

"Create a badge called 'Web Development Certificate' for completing our full-stack course"
"Create a Python certification badge with custom fields for completion date and final score"

4. issue_badge

वैकल्पिक मेटाडेटा के साथ एक प्राप्तकर्ता को बैज जारी करता है।

पैरामीटर:

  • badge_id (स्ट्रिंग, आवश्यक): निर्माण से बैज ID
  • name (स्ट्रिंग, आवश्यक): प्राप्तकर्ता का पूरा नाम
  • idempotency_key (स्ट्रिंग, आवश्यक): अद्वितीय पहचानकर्ता
  • email (स्ट्रिंग, वैकल्पिक): प्राप्तकर्ता का ईमेल
  • metadata (ऑब्जेक्ट, वैकल्पिक): कस्टम फ़ील्ड मान

उदाहरण:

"Issue the Web Development badge to John Doe with email john@example.com"
"Issue Python certification to Alice with completion date today and score 95%"

💬 प्राकृतिक भाषा उदाहरण

बैज बनाना

Human: "Create a badge for JavaScript mastery with fields for completion date and project count"

AI: I'll create a JavaScript mastery badge with the custom fields you specified.

✨ Badge Created Successfully!
🏷️ Badge Name: JavaScript Mastery Certificate
🆔 Badge ID: js_mastery_2024_001
📋 Custom fields: completion_date (date), project_count (number)

बैज जारी करना

Human: "Issue the JavaScript badge to Sarah Chen with completion date December 1st and 5 projects completed"

AI: I'll issue the JavaScript mastery badge to Sarah Chen with the specified details.

🎉 Badge Issued Successfully!
📧 Recipient: Sarah Chen  
🔗 Verification URL: https://yourdomain.com/verify/xyz123
📅 Completion Date: 2024-12-01
📊 Projects: 5

बैच संचालन

Human: "Create completion badges for all students in my Python course who scored above 85%"

AI: I'll help you create and issue completion badges for high-performing students. First, let me create a Python Course Completion badge, then we can issue it to qualified students.

[Creates badge and processes student list]

🏗️ विकास

स्रोत से बिल्ड करना

# Clone the repository
git clone https://github.com/issuebadge/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Lint code
npm run lint

# Format code
npm run format

प्रोजेक्ट संरचना

mcp-server/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript (generated)
├── .env.example         # Environment configuration template
├── package.json         # Node.js dependencies and scripts
├── tsconfig.json        # TypeScript configuration
└── README.md           # This file

🔒 सुरक्षा

  • सभी API संचार HTTPS का उपयोग करते हैं
  • प्रत्येक अनुरोध से पहले API कुंजियाँ मान्य की जाती हैं
  • निरर्थकता कुंजियाँ डुप्लिकेट संचालन रोकती हैं
  • मल्टी-टेनेंट डेटा पृथक्करण
  • अनुरोध टाइमआउट सुरक्षा
  • व्यापक त्रुटि प्रबंधन

📊 त्रुटि प्रबंधन

MCP सर्वर सामान्य समस्याओं के लिए विस्तृत त्रुटि संदेश प्रदान करता है:

  • प्रमाणीकरण त्रुटियाँ: अमान्य API कुंजियाँ या समाप्त टोकन
  • सत्यापन त्रुटियाँ: अनुपलब्ध आवश्यक पैरामीटर या अमान्य प्रारूप
  • नेटवर्क त्रुटियाँ: कनेक्शन टाइमआउट या सेवा अनुपलब्धता
  • व्यावसायिक तर्क त्रुटियाँ: डुप्लिकेट संचालन या अपर्याप्त अनुमतियाँ

🌍 उपयोग के मामले

शैक्षणिक संस्थान

  • पाठ्यक्रम पूर्णता: जब छात्र पाठ्यक्रम पूरा करते हैं तो स्वचालित रूप से बैज जारी करें
  • कौशल सत्यापन: मूल्यांकन स्कोर के साथ कौशल-आधारित बैज बनाएँ
  • स्नातक प्रमाणपत्र: शैक्षणिक विवरण के साथ थोक में स्नातक बैज जारी करें

कॉर्पोरेट प्रशिक्षण

  • प्रमाणन कार्यक्रम: समाप्ति तिथियों के साथ पेशेवर प्रमाणपत्र प्रबंधित करें
  • अनुपालन प्रशिक्षण: अनिवार्य प्रशिक्षण पूर्णता को ट्रैक और सत्यापित करें
  • कौशल विकास: आंतरिक कौशल विकास कार्यक्रमों के लिए बैज जारी करें

आयोजन प्रबंधन

  • सम्मेलन उपस्थिति: आयोजनों और कार्यशालाओं के लिए उपस्थिति बैज जारी करें
  • उपलब्धि ट्रैकिंग: चल रहे कार्यक्रमों के लिए प्रगतिशील बैज सिस्टम बनाएँ
  • वक्ता मान्यता: वक्ता और प्रतिभागी मान्यता बैज प्रबंधित करें

🤝 योगदान

हम योगदान का स्वागत करते हैं! कृपया हमारे योगदान दिशानिर्देश देखें:

  1. रिपॉजिटरी फोर्क करें
  2. एक फीचर शाखा बनाएँ: git checkout -b feature/amazing-feature
  3. अपने परिवर्तन कमिट करें: git commit -m 'Add amazing feature'
  4. शाखा में पुश करें: git push origin feature/amazing-feature
  5. एक पुल अनुरोध खोलें

विकास दिशानिर्देश

  • TypeScript सर्वोत्तम प्रथाओं का पालन करें
  • व्यापक त्रुटि प्रबंधन जोड़ें
  • फ़ंक्शन के लिए JSDoc टिप्पणियाँ शामिल करें
  • नई सुविधाओं के लिए परीक्षण अपडेट करें
  • सिमेंटिक वर्जनिंग का पालन करें

📝 लाइसेंस

यह प्रोजेक्ट MIT लाइसेंस के तहत लाइसेंस प्राप्त है - विवरण के लिए LICENSE फ़ाइल देखें।

🆘 समर्थन

सहायता प्राप्त करना

समस्या निवारण

सामान्य मुद्दे

1. API कुंजी सत्यापन विफल

# Check API key format (should start with number|)
# Verify the key hasn't expired
# Ensure correct base URL

2. कनेक्शन टाइमआउट

# Check network connectivity
# Verify IssueBadge service status
# Increase REQUEST_TIMEOUT in .env

3. बैज निर्माण त्रुटियाँ

# Verify required fields are provided
# Check idempotency key uniqueness
# Validate organization permissions

🔗 संबंधित परियोजनाएँ

📈 रोडमैप

संस्करण 1.1

  • बैच बैज संचालन
  • उन्नत फ़िल्टरिंग और खोज
  • वेबहुक एकीकरण
  • बैज टेम्पलेट प्रबंधन

संस्करण 1.2

  • विश्लेषिकी और रिपोर्टिंग उपकरण
  • कस्टम बैज सत्यापन नियम
  • शिक्षण प्रबंधन प्रणालियों के साथ एकीकरण
  • उन्नत वर्कफ़्लो स्वचालन

संस्करण 2.0

  • ब्लॉकचेन सत्यापन समर्थन
  • बहु-भाषा बैज सामग्री
  • उन्नत ब्रांडिंग अनुकूलन
  • एंटरप्राइज़ SSO एकीकरण

अपने बैज प्रबंधन में क्रांति लाने के लिए तैयार हैं? IssueBadge MCP सर्वर के साथ शुरुआत करें और संवादात्मक बैज प्रशासन की शक्ति का अनुभव करें!

IssueBadge टीम द्वारा ❤️ के साथ निर्मित