cpanel-mail-mcp

cPanel posta kutuları için stdio MCP sunucusu: IMAP + SMTP + CalDAV. Claude Code ve Claude masaüstü uygulamasına doğrudan bağlanır — OAuth shim, reverse proxy veya sürekli açık bir sunucu gerekmez.

Ekip üyeleri için kurulum talimatı: KURULUM.md

Kurulum

npx -y github:Burak-Kumas/cpanel-mail-mcp setup

Sihirbaz yalnızca e-posta adresi ve şifre sorar. Sunucu adını, portları ve takvimin var olup olmadığını kendisi tespit eder; şifreyi kaydetmeden önce gerçek bir IMAP girişiyle doğrular; ardından hem Claude Code'a hem masaüstü uygulamasına kaydeder.

Kurulum ~/.cpanel-mail-mcp/ altına yapılır (npx önbelleği geçici olduğu için kalıcı bir dizine kopyalanır), ayarlar ~/.cpanel-mail-mcp/.env dosyasında 600 izniyle tutulur.

Related MCP server: mcp-imap

Tasarım kararı

Sunucu process başına tek posta kutusu çalışır. Herkes kendi makinesinde kendi kimlik bilgisiyle bir örnek çalıştırır; şifre o makineden hiç çıkmaz.

Merkezî bir kurulum bilinçli olarak tercih edilmedi: cPanel'de mail için OAuth ya da uygulama şifresi yoktur, dolayısıyla merkezî bir sunucu herkesin düz IMAP şifresini saklamak zorunda kalırdı. O şifre kutuyu okuma ve o kişi adına mail gönderme yetkisinin tamamıdır — tek bir ihlal tüm ekibin yazışmasını açar.

Araçlar

Okuma: list_folders, list_messages, search_messages, get_message, list_attachments, save_attachment

Yazma: send_message (ek dosya destekli), reply_message (zincir başlıklarını ve alıntıyı korur, replyAll destekler), forward_message (ekleriyle birlikte), create_draft

Düzenleme: set_flags (okundu/yıldız/cevaplandı), move_message, archive_message, mark_spam, trash_message

Klasörler: create_folder, rename_folder, delete_folder, empty_trash

Takvim (yalnızca CALDAV_URL ayarlıysa): list_calendars, list_events, create_event, update_event, delete_event

Kalıcı silme: delete_message yalnızca ALLOW_DELETE=true ise açılır. Varsayılan kapalıdır; normal silme trash_message ile çöp kutusuna taşır ve geri alınabilir. INBOX klasörü silinemez.

Geliştirme

git clone https://github.com/Burak-Kumas/cpanel-mail-mcp.git
cd cpanel-mail-mcp
npm install
npm run build
cp .env.example .env   # kendi değerlerini gir
npm start

build/ depoya dahildir; npx github:... kurulumunun derleme adımı olmadan çalışabilmesi için gereklidir. Kaynak değiştirdiğinde npm run build çalıştırıp build/ çıktısını da commit et.

Notlar

• Ayarlar sunucunun kendi klasöründeki .env dosyasından okunur; gerçek ortam değişkenleri verilirse onlar önceliklidir.

• cPanel'in cpdavd servisi multistatus yanıtlarında yanlış href döndürdüğü için CalDAV keşfi elle yapılır (tsdav'ın otomatik keşfi bu sunucularda "cannot find homeUrl" hatası verir).

• Taslak klasörü IMAP SPECIAL-USE bayrağından bulunur; cPanel'de bu klasör Drafts değil INBOX.Drafts şeklindedir.

• Masaüstü uygulaması kullanıcının kabuğunu yüklemez, bu yüzden kayıt sırasında node yerine mutlak yol kullanılır (nvm bir kabuk fonksiyonudur ve masaüstü uygulamasında çözülmez).

• SMTP teslimatı Gönderilenler'e bir şey koymaz; gönderilen mesaj IMAP APPEND ile oraya ayrıca yazılır. Mesaj bir kez derlenip hem gönderilir hem kaydedilir, böylece iki kopyanın Message-ID'si aynı olur.

• raw ile gönderirken nodemailer alıcıları başlıklardan okumaz; envelope MailComposer.getEnvelope() ile ayrıca verilir (Bcc'yi de o taşır).

• Mesaj gövdeleri mailparser ile çözülür; ham kaynaktan başlık kesmek çok parçalı ve base64 kodlu mesajlarda okunaksız çıktı veriyordu.