Mailgun MCP Server

resmi

Mailgun API'si ile etkileşim kurun.

GitHub
56

Dokümantasyon

Mailgun MCP Sunucusu

MCP

Genel Bakış

Mailgun için, yapay zeka aracılarına e-posta gönderme, teslim edilebilirliği teşhis etme ve hesap işlemlerini yönetme için pratik, iş akışı odaklı bir arayüz sunan bir Model Bağlam Protokolü (MCP) sunucusu.

Not: Bu MCP sunucusu makinenizde yerel olarak çalışır. Mailgun şu anda bu sunucunun barındırılan bir sürümünü sunmamaktadır.

Yetenekler

  • Mesajlaşma — E-postalar gönderme, saklanan mesajları alma, mesajları yeniden gönderme
  • Alan Adları — Alan adı ayrıntılarını görüntüleme, DNS yapılandırmasını doğrulama, izleme ayarlarını yönetme (tıklama, açma, abonelikten çıkma)
  • Web Kancaları — Olay web kancalarını listeleme, oluşturma, güncelleme ve silme
  • Rotalar — Gelen e-posta yönlendirme kurallarını görüntüleme ve güncelleme
  • Posta Listeleri — Posta listeleri ve üyelerini oluşturma ve yönetme
  • Şablonlar — Sürümleme ile e-posta şablonları oluşturma ve yönetme
  • Analitik — Gönderim metriklerini, kullanım metriklerini ve günlükleri sorgulama
  • İstatistikler — Alan adı, etiket, sağlayıcı, cihaz ve ülkeye göre toplu istatistikleri görüntüleme
  • Engellemeler — Geri dönenler, abonelikten çıkmalar, şikayetler ve izin listesi girişlerini görüntüleme
  • IP'ler ve IP Havuzları — IP atamalarını ve özel IP havuzu yapılandırmasını görüntüleme
  • Geri Dönme Sınıflandırması — Geri dönme türlerini ve teslimat sorunlarını analiz etme

Ön Koşullar

  • Node.js (v20.12 veya üstü)
  • Mailgun hesabı ve API anahtarı

Hızlı Başlangıç

Yapılandırma

MCP istemci yapılandırmanıza aşağıdakini ekleyin:

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

Ortam Değişkenleri

DeğişkenGerekliVarsayılanAçıklama
MAILGUN_API_KEYEvet—Mailgun API anahtarınız
MAILGUN_API_REGIONHayırusAPI bölgesi: us veya eu
MAILGUN_MCP_TAGSHayır(tümü)Etkinleştirilecek virgülle ayrılmış ürün etiketleri. --tags ile eşdeğerdir. CLI bayrağı önceliklidir.

Etiket Filtreleme

Sunucunun hangi araçları kaydedeceğini bir veya daha fazla Mailgun ürün etiketiyle kapsamlandırabilirsiniz. Bu, modele gösterilen araç setini daraltmak için kullanışlıdır — örneğin, gönderme yeteneklerine ihtiyaç duymayan bir iş akışına yalnızca doğrulama araçlarını göstermek.

Geçerli etiketler: send, validate, optimize, inspect. Belirtilmediğinde, her araç kaydedilir (bugünkü varsayılan).

Filtreleme VEYA semantiği kullanır: bir araç, etiketlerinden herhangi biri aktif kümede görünüyorsa kaydedilir.

CLI bayrağı ile — MCP istemci yapılandırmanızın args kısmında --tags geçirin:

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

Ortam değişkeni ile — MAILGUN_MCP_TAGS ayarlayın (her ikisi de mevcutsa CLI bayrağı kazanır):

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

Keşfedilebilirlik — desteklenen etiket değerlerini yazdırmak için ikili dosyayı --list-tags ile, tam kullanım için --help ile çalıştırın. Bilinmeyen etiketler başlangıçta net bir hata mesajıyla reddedilir.

İstemciye Özel Yapılandırma Yolları

  • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop (Windows): %APPDATA%/Claude/claude_desktop_config.json
  • Claude Code: claude mcp add komutunu çalıştırın veya ~/.claude.json dosyasını düzenleyin

Örnek İstemler

Bir E-posta Gönder

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"!

Not: bazı MCP istemcileri, veri gönderen araçları çağırmak için ücretli bir plan gerektirir. Gönderme sessizce başarısız olursa, istemcinizin planını kontrol edin.

Gönderim İstatistiklerini Al ve Görselleştir

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

Şablonları Yönet

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

Teslim Edilebilirliği Araştır

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

DNS Sorunlarını Gider

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

Engellemeleri İncele

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

Yönlendirme Kurallarını Yönet

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

Bir Posta Listesi Oluştur

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

Alan Adlarını Karşılaştır

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

Bölgeye Göre Etkileşim

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

İzleme Ayarlarını İncele

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

Geliştirme

Kaynaktan çalıştırmak için, depoyu klonlayın ve doğrudan node kullanın:

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

MCP istemci yapılandırmanızda, npx komutunu şununla değiştirin:

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

Ön işleme kancaları

npm install, hazırlanmış TypeScript/JavaScript dosyalarında oxlint --fix ve oxfmt çalıştıran ve npm run check:versions çalıştıran bir git ön işleme kancası (husky aracılığıyla) yükler. Düzeltilebilir sorunlar otomatik olarak düzeltilir ve yeniden hazırlanır; düzeltilemez lint hataları veya sürüm senkronizasyonu uyumsuzlukları getiren işlemeler reddedilir. Bu değişiklikten önce zaten yerel bir klonunuz varsa, kancayı yüklemek için bir kez npm install çalıştırın.

Uç noktalar ekleme hakkında not

Yeni bir uç nokta eklerken, tanımı için düz bir dize kullanırsanız, varsayılan olarak _meta alanında send ürün türü ile etiketlenir. Farklı bir ürün olarak etiketlemek isterseniz, EndpointEntry türünün nesne sürümünü kullanın.

Güvenlik Hususları

API anahtarı izolasyonu

Mailgun API anahtarınız bir ortam değişkeni olarak iletilir ve asla yapay zeka modelinin kendisine gösterilmez — yalnızca MCP sunucu süreci tarafından istekleri doğrulamak için kullanılır. Sunucu, API anahtarlarını, istek parametrelerini veya yanıt verilerini günlüğe kaydetmez.

Yerel yürütme

Sunucu makinenizde yerel olarak çalışır. Mailgun API ile tüm iletişim, TLS sertifika doğrulaması zorunlu olarak HTTPS üzerinden yapılır. Mailgun API'si dışında üçüncü taraf hizmetlere hiçbir veri gönderilmez.

API anahtarı izinleri

Yalnızca ihtiyacınız olan işlemlere kapsamlandırılmış izinlere sahip özel bir Mailgun API anahtarı kullanın. Sunucu, okuma ve güncelleme işlemlerini sunar ancak hiçbir silme işlemini sunmaz, bu da istenmeyen eylemlerin etki alanını sınırlar.

Hız sınırlaması

Sunucu, istemci tarafı hız sınırlaması uygulamaz. Yapay zekadan gelen her araç çağrısı doğrudan bir Mailgun API isteğine dönüşür. Sunucu, kötüye kullanımı önlemek için Mailgun'un sunucu tarafı hız sınırlarına güvenir — bu sınırları aşan istekler yapay zeka asistanına bir hata döndürür.

İstem enjeksiyonu

Herhangi bir MCP sunucusunda olduğu gibi, hazırlanmış veya düşmanca bir istem, yapay zeka asistanını, örneğin izleme ayarlarını değiştirmek veya posta listesi üyelerini okumak gibi, amaçlamadığınız işlemleri çağırması için kandırabilir. Özellikle güvenilmeyen istem bağlamlarında, eylemleri onaylamadan önce yapay zeka asistanınızın araç çağrı onaylarını gözden geçirin.

Web kancası URL'leri

Web kancası oluşturma ve güncelleme işlemleri, yapay zeka asistanı aracılığıyla sağlanan rastgele URL'leri kabul eder. MCP sunucusu bu URL'leri ek doğrulama olmadan Mailgun API'sine iletir. Web kancası hedeflerini doğrulamaktan Mailgun sorumludur. Yapay zeka asistanınızın web kancası URL'lerini istenmeyen dahili veya hassas adreslere ayarlamadığından emin olun.

Girdi doğrulaması

Tüm araç parametreleri, Zod şemaları kullanılarak Mailgun OpenAPI spesifikasyonuna göre doğrulanır. Ancak doğrulama, OpenAPI spesifikasyonunun doğruluğuna bağlıdır ve bazı uç durum parametreleri izin verici doğrulamaya geri dönebilir. Mailgun API'si, ek bir koruma katmanı olarak kendi sunucu tarafı doğrulamasını gerçekleştirir.

Hata Ayıklama

MCP sunucusu stdio üzerinden iletişim kurar. Sorun giderme için MCP Hata Ayıklama Kılavuzuna bakın.

Lisans

Apache 2.0 — ayrıntılar için LICENSE dosyasına bakın.

Katkıda Bulunma

Katkılarınızı memnuniyetle karşılıyoruz! Lütfen bir Çekme İsteği göndermekten veya bir Sorun açmaktan çekinmeyin.