Yapay Zeka Yerel MCP Sunucusu

SMSBulk MCP Sunucusu

SMSBulk'u doğrudan Claude Desktop, Cursor veya MCP uyumlu herhangi bir istemciden kullanın — SMS numaraları ve tek kullanımlık e-posta adresleri sipariş edin, kodları geri okuyun.

Model Context Protocol (MCP), yapay zeka asistanlarının harici araçları çağırmasını sağlar. Bu açık kaynaklı sunucu, SMSBulk API'sini yapay zeka istemcinize bağlar; iş mantığı içermez ve hiçbir sır saklamaz.

GitHub'da açık kaynak

Ne işe yarar

Sunucu saf bir aktarıcıdır: her isteği kendi API anahtarınızla SMSBulk genel API'sine iletir. Dört grupta 18 araç sunar — katalog, SMS, cüzdan ve e-posta.

Yalnızca SMS sunan sağlayıcıların aksine SMSBulk hem telefon hem e-posta doğrulaması sunar. E-posta araçlarının rakip MCP sunucularının çoğunda karşılığı yoktur.

Kurulum

Node.js 18 veya üzerini gerektirir. Depoyu klonlayın, bağımlılıkları kurun ve derleyin:

git clone https://github.com/Tolunay3434/smsbulk-mcp.git
cd smsbulk-mcp
npm install
npm run build

Ardından MCP istemcinizi derlenen dist/index.js dosyasına yönlendirin. Katalog araçları anahtarsız çalışır; diğer tüm araçlar SMSBulk API anahtarınızı gerektirir.

İstemci yapılandırması

Claude Desktop

{
  "mcpServers": {
    "smsbulk": {
      "command": "node",
      "args": ["/absolute/path/to/smsbulk-mcp/dist/index.js"],
      "env": {
        "SMSBULK_API_KEY": "your_api_key_here",
        "MAX_SPEND_PER_SESSION": "5"
      }
    }
  }
}

Bunu claude_desktop_config.json dosyasına ekleyin ve Claude Desktop'ı yeniden başlatın. SMSBulk araçları araçlar menüsünde görünür.

Cursor

{
  "mcpServers": {
    "smsbulk": {
      "command": "node",
      "args": ["/absolute/path/to/smsbulk-mcp/dist/index.js"],
      "env": {
        "SMSBULK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Bunu ~/.cursor/mcp.json (genel) veya .cursor/mcp.json (projeye özel) dosyasına ekleyin.

/absolute/path/to/smsbulk-mcp ifadesini depoyu klonladığınız gerçek yolla değiştirin. API anahtarınızı asla depoya göndermeyin.

Araç referansı

18 araç. Katalog araçları anahtar gerektirmez; diğerleri x-api-key gönderir.

Katalog

API anahtarı gerekmez

list_services—

Stok ve minimum fiyat özetleriyle tüm aktif servisler.

list_countries—

Bayrak ve ISO kodlarıyla desteklenen tüm ülkeler.

get_serviceslug

SEO slug veya servis koduyla aranan tek bir servis.

get_service_countriesslug

Bir servis için stokta bulunan ülkeler; fiyat, stok ve hız katmanlarıyla.

SMS doğrulama

API anahtarı gerekir

request_numberserviceCode, countryIso, operator?, idempotency_token?Harcar

SMS doğrulaması için numara ayırır. Tekrar koruması vardır.

get_statusid

Bir aktivasyonun durumu ve (geldiğinde) SMS kodu.

completeid

Aktivasyonu tamamlanmış olarak işaretler. Bu kalıcıdır.

cancelid

Aktivasyonu iptal eder; SMS gelmediyse cüzdana iade yapar.

request_resendid

Sağlayıcıdan aynı numaraya yeni bir SMS göndermesini ister.

list_activationslimit?, cursor?, status?

Aktivasyonlarınız; imleçle sayfalanır, en yeni önce.

Cüzdan

API anahtarı gerekir

get_balance—

Güncel cüzdan bakiyeniz.

list_transactionslimit?, cursor?

Son yatırımlar, harcamalar ve iadeler.

E-posta doğrulama

API anahtarı gerekirYalnızca SMS sunan sunucularda yok

email_get_domainssite

Hedef site için mevcut e-posta sağlayıcı alan adları; fiyat ve stokla.

email_requestsite, domain, idempotency_token?Harcar

Tek kullanımlık bir e-posta adresi ayırır. Tekrar koruması vardır.

email_listlimit?

Son e-posta aktivasyonlarınız; en yeni önce (en fazla 100, imleç yok).

email_get_statusid

Durum, ayrıştırılmış OTP ve ham HTML gövdesi (geldiğinde).

email_reorderidHarcar

Yeni bir OTP için aynı adresi yeniden açar.

email_cancelid

İptal eder; OTP gelmediyse cüzdana iade yapar.

Güvenlik ve sınırlamalar

Bu korumalar birer kolaylık emniyet kemeridir, garanti değildir.

Olabildiğince tekrar koruması — garantili idempotency değildir

request_number ve email_request, yaygın kaza durumunu yakalayan küçük bir bellek içi koruma tutar: aynı sipariş aracı tek oturumda aynı argümanlarla iki kez çağrılırsa, ikinci çağrı tekrar ücret almak yerine ilk sonucu döndürür. Bu garantili idempotency değildir — yalnızca bu işlemin belleğinde yaşar, yeniden başlatmada sıfırlanır, istemciler arasında eşgüdüm sağlamaz ve gerçek bir sunucu tarafı yarış durumunu engelleyemez. Tek bir siparişi güvenle yeniden denemek için aynı idempotency_token'ı geçin; bilerek ikinci bir sipariş vermek için farklı bir token geçin.

Yumuşak harcama limiti (MAX_SPEND_PER_SESSION)

Ayarlandığında sunucu, başarılı her siparişin gerçek maliyetini izler ve toplam, limitinize ulaştığında bir sonraki siparişi engeller. Yumuşak ve bellek içidir — yeniden başlatmada sıfırlanır, yalnızca bu oturumu kapsar ve tek bir isteği bölmek yerine bir sonraki isteği engeller. Limitin altındayken verilen bir sipariş, toplamı limitin üzerine çıkarsa bile kabul edilir. Bu, hesabınızın sunucu tarafı sınırlarının (bakiye, günlük kota, hız sınırları) üzerine eklenen ek bir katmandır.

Doğrulamayı yapay zeka iş akışınıza taşıyın

Sunucuyu klonlayın, API anahtarınızı ekleyin ve SMS veya e-posta kodlarını doğrudan asistanınızdan sipariş edin.

GitHub'da görüntüle API anahtarı al SMS API dokümanı E-posta API dokümanı