Shamela Chatgpt

Şâmile 4 kütüphanesini ChatGPT / Codex içinde kullanmak için hazırlanmış yerel entegrasyon.

Bu proje, bilgisayarınızda kurulu olan al-Maktaba al-Shamela (المكتبة الشاملة) kütüphanesini yerel bir MCP sunucusu üzerinden ChatGPT'ye bağlar.

Şâmile kitapları bu repository içerisinde bulunmaz. Kullanıcının kendi bilgisayarında Şâmile 4 kurulu olmalıdır.

---

Özellikler

Shamela for ChatGPT ile Şâmile kütüphanesi üzerinde:

• Kitap arama
• Müellif arama
• Arapça tam metin araması
• Kitap sayfalarını okuma
• Bölüm ve başlıkları bulma
• Kur'an ayeti arama
• Tefsir kaynaklarında araştırma
• Hadis arama
• Şâmile book_id bilgilerini kullanma
• Akademik kaynak araştırması

yapılabilir.

ChatGPT içinde örneğin:

@Shamela Taberî'nin Bakara 2/10 tefsirini Şâmile'den bul.

şeklinde kullanılabilir.

---

Sistem Desteği

macOS

Durum:

Test edildi ve çalışıyor.

İlk sürüm Apple Silicon Mac üzerinde test edilmiştir.

Windows

Durum:

Beta — henüz gerçek bir Windows cihazında test edilmedi.

Windows installer hazırlanmıştır. İlk gerçek Windows testinden sonra gerekli düzeltmeler yapılacaktır.

---

Gereksinimler

Kurulum için:

• Şâmile 4
• Node.js 20 veya üzeri
• JDK 21 veya üzeri
• ChatGPT Desktop
• İnternet bağlantısı

gereklidir.

Kurucu ayrıca Shamela plugin'inin kurulması için gerekli Codex CLI ve marketplace işlemlerini gerçekleştirir veya mevcut kurulumu kullanır.

---

macOS Kurulumu

Terminal'i açın.

Repository'yi indirin:

git clone https://github.com/omerfaruk-oz/shamela-chatgpt.git

Klasöre girin:

cd shamela-chatgpt

Installer'ı çalıştırılabilir hale getirin:

chmod +x installer/install-macos.sh

Kurulumu başlatın:

./installer/install-macos.sh

Installer otomatik olarak:

1. Şâmile 4 kurulumunu kontrol eder.
2. Node.js sürümünü kontrol eder.
3. JDK sürümünü kontrol eder.
4. Shamela MCP v1.2.0'ı indirir.
5. Şâmile'nin gerekli Java kütüphanelerini MCP'ye ekler.
6. MCP sunucusunu derler.
7. MCP yapılandırmasını oluşturur.
8. Codex CLI'yi kontrol eder.
9. Shamela marketplace'i ekler.
10. Shamela plugin'ini kurar ve etkinleştirir.

Kurulum tamamlandıktan sonra ChatGPT Desktop'ı tamamen kapatın:

Command + Q

Ardından tekrar açın.

Yeni bir sohbet açıp:

@Shamela

yazın.

---

Windows Kurulumu

Not: Windows installer şu anda beta durumundadır ve henüz gerçek bir Windows bilgisayarda test edilmemiştir.

Öncelikle GitHub repository'sini indirin.

Git kullanıyorsanız PowerShell'de:

git clone https://github.com/omerfaruk-oz/shamela-chatgpt.git

Ardından:

cd shamela-chatgpt

Installer'ı çalıştırın:

powershell -ExecutionPolicy Bypass -File .\installer\install-windows.ps1

Windows installer:

1. Şâmile 4 kurulumunu bulmaya çalışır.
2. Otomatik bulamazsa kullanıcıdan Şâmile klasörünü ister.
3. Node.js 20+ kontrolü yapar.
4. JDK 21+ kontrolü yapar.
5. Shamela MCP v1.2.0'ı indirir.
6. Gerekli Şâmile Java kütüphanelerini ekler.
7. MCP sunucusunu derler.
8. Codex / ChatGPT MCP yapılandırmasını oluşturur.
9. Codex CLI'yi kontrol eder.
10. Shamela marketplace'i ekler.
11. Shamela plugin'ini kurar ve etkinleştirir.

Kurulum tamamlandıktan sonra ChatGPT Desktop'ı tamamen kapatıp yeniden açın.

Ardından yeni bir sohbette:

@Shamela

yazarak kullanabilirsiniz.

---

Kurulum Sonrası Kontrol

Codex CLI üzerinden plugin durumunu görmek için:

codex plugin list

Başarılı bir kurulumda aşağıdakine benzer bir satır görülmelidir:

shamela@shamela-chatgpt    installed, enabled    1.0.0

---

Nasıl Çalışır?

Proje iki ana bileşenden oluşur.

1. Shamela MCP

Şâmile 4'ün bilgisayarınızdaki yerel verilerine erişir.

MCP sunucusu olarak aşağıdaki açık kaynak proje kullanılmaktadır:

https://github.com/alhoqbani/shamela-mcp

2. Shamela ChatGPT Plugin

Bu repository içerisindeki plugin, ChatGPT / Codex'e Şâmile kaynaklarının nasıl kullanılacağını tanımlar.

Plugin marketplace üzerinden kurulur:

shamela@shamela-chatgpt

Böylece Şâmile araştırmaları doğrudan ChatGPT içerisinde gerçekleştirilebilir.

---

Örnek Kullanımlar

Tefsir

@Shamela Taberî'nin Bakara 2/10 ayeti hakkındaki açıklamalarını bul.

Hadis

@Shamela إنما الأعمال بالنيات hadisini Şâmile kaynaklarında ara.

Kitap

@Shamela İbnü'l-Cezerî'nin en-Neşr fi'l-kırââti'l-aşr kitabını bul.

Arapça metin

@Shamela "اختلاف القراءات" ifadesini Şâmile kitaplarında ara.

Akademik araştırma

@Shamela Bakara 2/10'daki يكذبون ve يكذبون kıraat farklılığını klasik kaynaklardan araştır.

---

Veri ve Gizlilik

Bu repository:

• Şâmile kitap veritabanını içermez.
• Şâmile PDF koleksiyonunu içermez.
• Kullanıcının kitaplarını GitHub'a yüklemez.

Şâmile verileri kullanıcının kendi bilgisayarında bulunur.

MCP sunucusu yerel Şâmile kurulumuna erişir.

---

Proje Yapısı

shamela-chatgpt/
│
├── .agents/
│   └── plugins/
│       └── marketplace.json
│
├── plugin/
│   └── Shamela/
│       ├── .codex-plugin/
│       ├── skills/
│       └── README.md
│
├── installer/
│   ├── install-macos.sh
│   └── install-windows.ps1
│
├── README.md
├── LICENSE
└── THIRD_PARTY_NOTICES.md

---

Shamela MCP

Bu proje aşağıdaki açık kaynak MCP sunucusunu kullanır:

https://github.com/alhoqbani/shamela-mcp

Shamela MCP'nin telif ve lisans hakları kendi geliştiricisine aittir.

Bu proje Shamela MCP'yi yeniden dağıtmak yerine kurulum sırasında ilgili sürümü indirir ve yerel olarak derler.

---

Lisans

Shamela for ChatGPT plugin ve installer dosyaları MIT lisansı altında yayımlanmaktadır.

Üçüncü taraf bileşenler kendi lisanslarına tabidir.

Detaylar için:

LICENSE
THIRD_PARTY_NOTICES.md

dosyalarına bakabilirsiniz.

---

Durum

Platform	Durum
macOS Apple Silicon	✅ Test edildi
macOS Intel	⚠️ Henüz test edilmedi
Windows	🧪 Beta / henüz test edilmedi

---

Katkı ve Hata Bildirimi

Windows veya farklı bir macOS sisteminde kurulum sırasında sorun yaşarsanız GitHub Issues üzerinden bildirebilirsiniz.

Özellikle Windows test sonuçları projenin geliştirilmesine yardımcı olacaktır.