Mailgun MCP Server

Mailgun MCP सर्वर

अवलोकन

Mailgun के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर जो AI एजेंटों को ईमेल भेजने, डिलीवरेबिलिटी का निदान करने और खाता संचालन प्रबंधित करने के लिए एक व्यावहारिक, कार्यप्रवाह-उन्मुख इंटरफ़ेस देता है।

नोट: यह MCP सर्वर आपकी मशीन पर स्थानीय रूप से चलता है। Mailgun वर्तमान में इस सर्वर का होस्टेड संस्करण प्रदान नहीं करता है।

क्षमताएँ

• मैसेजिंग — ईमेल भेजें, संग्रहीत संदेश पुनर्प्राप्त करें, संदेश पुनः भेजें
• डोमेन — डोमेन विवरण देखें, DNS कॉन्फ़िगरेशन सत्यापित करें, ट्रैकिंग सेटिंग प्रबंधित करें (क्लिक, खोलें, सदस्यता समाप्त करें)
• वेबहुक — ईवेंट वेबहुक सूचीबद्ध करें, बनाएँ, अपडेट करें और हटाएँ
• रूट — इनबाउंड ईमेल रूटिंग नियम देखें और अपडेट करें
• मेलिंग सूचियाँ — मेलिंग सूचियाँ और उनके सदस्य बनाएँ और प्रबंधित करें
• टेम्पलेट — संस्करणीकरण के साथ ईमेल टेम्पलेट बनाएँ और प्रबंधित करें
• एनालिटिक्स — भेजने के मीट्रिक, उपयोग मीट्रिक और लॉग क्वेरी करें
• स्टैट्स — डोमेन, टैग, प्रदाता, डिवाइस और देश के अनुसार समग्र आँकड़े देखें
• दमन — बाउंस, सदस्यता समाप्ति, शिकायतें और अनुमति सूची प्रविष्टियाँ देखें
• IP और IP पूल — IP असाइनमेंट और समर्पित IP पूल कॉन्फ़िगरेशन देखें
• बाउंस वर्गीकरण — बाउंस प्रकारों और डिलीवरी समस्याओं का विश्लेषण करें

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

• Node.js (v20.12 या उच्चतर)
• Mailgun खाता और API कुंजी

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

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

अपने MCP क्लाइंट कॉन्फ़िगरेशन में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key",
        "MAILGUN_API_REGION": "us"
      }
    }
  }
}

पर्यावरण चर

चर	आवश्यक	डिफ़ॉल्ट	विवरण
MAILGUN_API_KEY	हाँ	—	आपकी Mailgun API कुंजी
MAILGUN_API_REGION	नहीं	us	API क्षेत्र: us या eu
MAILGUN_MCP_TAGS	नहीं	(सभी)	सक्षम करने के लिए अल्पविराम-पृथक उत्पाद टैग। --tags के समतुल्य। CLI फ़्लैग को प्राथमिकता दी जाती है।

टैग फ़िल्टरिंग

आप सर्वर द्वारा पंजीकृत टूल को एक या अधिक Mailgun उत्पाद टैग तक सीमित कर सकते हैं। यह मॉडल को दिखाए जाने वाले टूलसेट को संकीर्ण करने के लिए उपयोगी है — उदाहरण के लिए, केवल सत्यापन टूल को ऐसे कार्यप्रवाह में उजागर करना जिसे भेजने की क्षमताओं की आवश्यकता नहीं है।

मान्य टैग: send, validate, optimize, inspect। जब अनिर्दिष्ट हो, तो हर टूल पंजीकृत होता है (आज का डिफ़ॉल्ट)।

फ़िल्टरिंग OR शब्दार्थ का उपयोग करती है: एक टूल पंजीकृत होता है यदि उसका कोई भी टैग सक्रिय सेट में दिखाई देता है।

CLI फ़्लैग के माध्यम से — अपने MCP क्लाइंट कॉन्फ़िग के args में --tags पास करें:

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server", "--tags", "validate,inspect"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
      }
    }
  }
}

पर्यावरण चर के माध्यम से — MAILGUN_MCP_TAGS सेट करें (यदि दोनों मौजूद हैं तो CLI फ़्लैग जीतता है):

"env": {
  "MAILGUN_API_KEY": "YOUR-mailgun-api-key",
  "MAILGUN_MCP_TAGS": "validate,inspect"
}

खोज योग्यता — समर्थित टैग मान मुद्रित करने के लिए --list-tags के साथ बाइनरी चलाएँ, या पूर्ण उपयोग के लिए --help। अज्ञात टैग स्टार्टअप पर एक स्पष्ट त्रुटि संदेश के साथ अस्वीकार कर दिए जाते हैं।

क्लाइंट-विशिष्ट कॉन्फ़िग पथ

• क्लाउड डेस्कटॉप (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• क्लाउड डेस्कटॉप (Windows): %APPDATA%/Claude/claude_desktop_config.json
• क्लाउड कोड: claude mcp add चलाएँ या ~/.claude.json संपादित करें

नमूना संकेत

एक ईमेल भेजें

Can you send an email to EMAIL_HERE with a funny email body that makes it sound
like it's from the IT Desk from Office Space? Please use the sending domain
DOMAIN_HERE, and make the email from "postmaster@DOMAIN_HERE"!

नोट: कुछ MCP क्लाइंट को डेटा भेजने वाले टूल लागू करने के लिए भुगतान योजना की आवश्यकता होती है। यदि भेजना चुपचाप विफल हो जाता है, तो अपने क्लाइंट की योजना की जाँच करें।

भेजने के आँकड़े प्राप्त करें और विज़ुअलाइज़ करें

Would you be able to make a chart with email delivery statistics for the past week?

टेम्पलेट प्रबंधित करें

Create a welcome email template for new signups on my domain DOMAIN_HERE.
Include a personalized greeting and a call-to-action button.

डिलीवरेबिलिटी की जाँच करें

Can you check the bounce classification stats for my account and tell me
what the most common bounce reasons are?

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

Check the DNS verification status for my domain DOMAIN_HERE and tell me
if anything needs fixing.

दमन की समीक्षा करें

Are there any unsubscribes or complaints for DOMAIN_HERE? Summarize the
top offenders.

रूटिंग नियम प्रबंधित करें

List all my inbound routes and explain what each one does.

एक मेलिंग सूची बनाएँ

Create a mailing list called announcements@DOMAIN_HERE and add these
members: [email protected], [email protected].

डोमेन की तुलना करें

Compare my sending volume and delivery rates across all my domains for
the past month.

क्षेत्र के अनुसार सहभागिता

Break down my email engagement by country and device for DOMAIN_HERE.

ट्रैकिंग सेटिंग्स की समीक्षा करें

List all my domains and show which ones have tracking enabled for clicks
and opens.

विकास

स्रोत से चलाने के लिए, रिपॉजिटरी क्लोन करें और सीधे node का उपयोग करें:

git clone https://github.com/mailgun/mailgun-mcp-server.git
cd mailgun-mcp-server
npm install
npm test

अपने MCP क्लाइंट कॉन्फ़िग में, npx कमांड को इससे बदलें:

"command": "node",
"args": ["/path/to/mailgun-mcp-server/src/mailgun-mcp.js"]

प्री-कमिट हुक

npm install एक git प्री-कमिट हुक स्थापित करता है (हस्की के माध्यम से) जो स्टेज की गई TypeScript/JavaScript फ़ाइलों पर oxlint --fix और oxfmt चलाता है और npm run check:versions चलाता है। ठीक करने योग्य मुद्दे स्वतः ठीक किए जाते हैं और पुनः स्टेज किए जाते हैं; ऐसे कमिट जो न सुधरे जा सकने वाली लिंट त्रुटियाँ या संस्करण-सिंक बेमेल पेश करते हैं, अस्वीकार कर दिए जाते हैं। यदि इस परिवर्तन से पहले आपके पास पहले से एक स्थानीय क्लोन था, तो हुक स्थापित करने के लिए एक बार npm install चलाएँ।

एंडपॉइंट जोड़ने पर नोट

एक नया एंडपॉइंट जोड़ते समय यदि आप इसकी परिभाषा के लिए एक सादे स्ट्रिंग का उपयोग करते हैं तो यह डिफ़ॉल्ट रूप से _meta फ़ील्ड में send उत्पाद प्रकार के साथ टैग किया जाएगा। यदि आप इसे एक अलग उत्पाद के रूप में टैग करना चाहते हैं तो EndpointEntry प्रकार के ऑब्जेक्ट संस्करण का उपयोग करें।

सुरक्षा विचार

API कुंजी पृथक्करण

आपकी Mailgun API कुंजी एक पर्यावरण चर के रूप में पारित की जाती है और कभी भी AI मॉडल के सामने उजागर नहीं होती है — इसका उपयोग केवल MCP सर्वर प्रक्रिया द्वारा अनुरोधों को प्रमाणित करने के लिए किया जाता है। सर्वर API कुंजी, अनुरोध पैरामीटर या प्रतिक्रिया डेटा लॉग नहीं करता है।

स्थानीय निष्पादन

सर्वर आपकी मशीन पर स्थानीय रूप से चलता है। Mailgun API के साथ सभी संचार HTTPS पर TLS प्रमाणपत्र सत्यापन लागू होने के साथ होता है। Mailgun API से परे किसी तृतीय-पक्ष सेवा को कोई डेटा नहीं भेजा जाता है।

API कुंजी अनुमतियाँ

केवल उन कार्यों तक सीमित अनुमतियों वाली एक समर्पित Mailgun API कुंजी का उपयोग करें जिनकी आपको आवश्यकता है। सर्वर पढ़ने और अपडेट करने के संचालन को उजागर करता है लेकिन किसी भी हटाने के संचालन को उजागर नहीं करता है, जो अनपेक्षित कार्यों के विस्फोट त्रिज्या को सीमित करता है।

दर सीमित करना

सर्वर क्लाइंट-साइड दर सीमित करना लागू नहीं करता है। AI से प्रत्येक टूल कॉल सीधे Mailgun API अनुरोध में अनुवादित होती है। सर्वर दुरुपयोग को रोकने के लिए Mailgun की सर्वर-साइड दर सीमाओं पर निर्भर करता है — उन सीमाओं से अधिक अनुरोध AI सहायक को एक त्रुटि लौटाएँगे।

प्रॉम्प्ट इंजेक्शन

किसी भी MCP सर्वर की तरह, एक तैयार किया गया या विरोधी प्रॉम्प्ट AI सहायक को ऐसे संचालन करने के लिए बरगला सकता है जो आपने इरादा नहीं किया था — उदाहरण के लिए, ट्रैकिंग सेटिंग्स को संशोधित करना या मेलिंग सूची के सदस्यों को पढ़ना। कार्यों को स्वीकृत करने से पहले अपने AI सहायक की टूल-कॉल पुष्टियों की समीक्षा करें, विशेष रूप से अविश्वसनीय प्रॉम्प्ट संदर्भों में।

वेबहुक URL

वेबहुक बनाने और अपडेट करने के संचालन AI सहायक के माध्यम से प्रदान किए गए मनमाने URL स्वीकार करते हैं। MCP सर्वर इन URL को बिना अतिरिक्त सत्यापन के Mailgun API को भेजता है। Mailgun वेबहुक गंतव्यों को मान्य करने के लिए जिम्मेदार है। सुनिश्चित करें कि आपका AI सहायक अनपेक्षित आंतरिक या संवेदनशील पतों पर वेबहुक URL सेट न करे।

इनपुट सत्यापन

सभी टूल पैरामीटर Zod स्कीमा का उपयोग करके Mailgun OpenAPI विनिर्देश के विरुद्ध मान्य किए जाते हैं। हालाँकि, सत्यापन OpenAPI विनिर्देश की सटीकता पर निर्भर करता है, और कुछ किनारे-मामले पैरामीटर अनुमेय सत्यापन पर वापस आ सकते हैं। Mailgun API सुरक्षा की एक अतिरिक्त परत के रूप में अपना स्वयं का सर्वर-साइड सत्यापन करता है।

डिबगिंग

MCP सर्वर stdio पर संचार करता है। समस्या निवारण के लिए MCP डिबगिंग गाइड देखें।

लाइसेंस

Apache 2.0 — विवरण के लिए LICENSE देखें।

योगदान

हम योगदान का स्वागत करते हैं! कृपया बेझिझक एक पुल अनुरोध सबमिट करें या एक मुद्दा खोलें।